> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/canais/whatsapp/zenvia.md).

# Zenvia

A Zenvia é uma plataforma que permite a integração com canais como RCS e Facebook. Caso a sua empresa possua uma conta na Zenvia e ofereça atendimentos por meio do canal WhatsApp, poderá integrar este canal aos assistentes do Zenvia NLU, isso permitirá utilizar os assistentes e todos os recursos do Zenvia NLU sem a necessidade de trocar o número de atendimento que já é conhecido por seus clientes.

### Configurações

Para começar, acesse a plataforma Zenvia NLU, vá em **Connect > Canais > WhatsApp** e clique em **Zenvia** para visualizar suas integrações. Na tela "**Integrações com Zenvia**", clique no botão ➕ para criar uma nova integração e preencha os seguintes campos:

![](/files/GY0WOofjh6RroXJzCzNj)

* **Nome:** nome da sua integração
* **Assistente:** selecione o [assistente](https://docs.altu.com.br/builder/assistentes)
* **Squads:** selecione o nome da squad se estiver disponível na lista, caso contrário mantenha como “geral”
* **Sender ID:** o identificador do remetente da mensagem. O remetente é criado quando uma integração para o canal é conectada no [console de integração](https://app.zenvia.com/home/credentials). Copie o **Sender ID** da conta desejada em [Integrações WhatsApp](https://app.zenvia.com/home/credentials/whatsapp/list) dentro da plataforma Zenvia
* **API Token:** token para autorização de envio de mensagens ao usuário. Você pode gerar seu token no [console da API](https://app.zenvia.com/home/api) dentro da plataforma Zenvia
* **Mensagens para mídias não suportadas:** mensagens que serão exibidas caso o usuário envie um tipo de mensagem não suportado
* **Telefones de Homologação:** telefones para teste do fluxo de atendimento

Após criar a integração, volte para a tela de "**Integrações com Zenvia**" e clique no botão de editar integração para consultar suas URL's de Webhook. As mensagens enviadas pelos usuários para o seu número de WhatsApp deverão ser entregues nesta URL.

Utilize as informações da seção **Webhooks** **de status** para realizar a configuração em sua conta Zenvia. Estas informações são semelhantes às mostradas abaixo:

![](/files/n3BekWpazG4nuyvCK6AW)

Exemplos:

{% tabs %}
{% tab title="1" %}

```
{
  "external_id": "ab91e2a0-a46c-11eb-bf0a-9733e9a045ee",
  "status": "error",
  "destination": "+5511977875009",
  "date": "2021-04-23T16:47:01-03:00",
  "message": "The message was rejected by the provider"
}
```

{% endtab %}

{% tab title="2" %}

```
{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "sent",
  "destination": "+5535984146213",
  "date": "2021-04-23T16:48:36-03:00"
}
```

{% endtab %}

{% tab title="3" %}

```
{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "delivered",
  "destination": "+5535984146213",
  "date": "2021-04-23T16:48:37-03:00"
}
```

{% endtab %}

{% tab title="4" %}

```
{
  "external_id": "e47e5580-a46c-11eb-bf0a-9733e9a045ee",
  "status": "read",
  "destination": "+5535984146213",
  "date": "2021-04-23T16:48:44-03:00"
}
```

{% endtab %}
{% endtabs %}

Acesse a página inicial do portal Zenvia, vá em **Produtos > Tokens e Webhooks** para acessar o [console da API](https://app.zenvia.com/home/api).

Na seção **Webhooks**, clique no botão "**Criar Novo**" para criar um novo webhook e preencha os seguintes campos:

![](/files/nEyvnXSdCCota0fl0Ujy)

* **Status**: o status da subscrição. Deixe esta opção **ativa**
* **Versão**: a versão da subscrição. Selecione a opção **v2**
* **Tipo do evento**: o tipo do evento da subscrição. Selecione a opção **Mensagem** para receber mensagens dos usuários
* **Canal**: o canal da subscrição. Selecione a opção **WhatsApp**
* **URL**: URL usada para receber as mensagens de seus clientes. Consulte a URL na plataforma Zenvia NLU, em **Entrada de Mensagens** da seção [Webhooks](/connect/apis/outbound.md#webhook-de-status)
* **Cabeçalhos**: informações de autenticação na chamada de webhook. Adicione um cabeçalho para AuthenticationToken. Consulte o cabeçalho na plataforma Zenvia NLU, no **Header** da seção **Webhooks**

{% hint style="info" %}
Você também poderá gerenciar os seus webhooks utilizando a [ZenAPI](https://zenvia.github.io/zenvia-openapi-spec/v2/). Para mais informações consulte a documentação na seção [Webhooks](https://zenvia.github.io/zenvia-openapi-spec/v2/#tag/Webhooks).
{% endhint %}