# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.altu.d1.cx/connect/canais/whatsapp/zenvia.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.