Neste artigo, você encontrará todas as informações necessárias para conectar seu assistente Zenvia NLU ao WhatsApp.

Como funciona

A integração da Zenvia NLU com o WhatsApp acontece por intermédio da Zenvia.

Sendo assim, todo o funcionamento do assistente consiste na integração do App Zenvia com o Whatsapp do cliente e a posterior configuração do ORGANIZATION ID na plataforma.

💡 Dica: confira este artigo sobre Configurar o Whatsapp com o App Zenvia

Siga as instruções abaixo para configurar o ORGANIZATION ID:

1. Acesse o App Zenvia;
2. Clique no nome da Organização > Preferências no canto superior direito;
3. Copie o ID da ORG que estará na URL.

Criar integração na Zenvia NLU

Siga as etapas abaixo para criar sua integração:

1. Acesse Connect > Canais > WhatsApp, clique em Zenvia;
2. Na tela Integrações com Zenvia WhatsApp, clique no botão ➕ no canto inferior direito;
3. Crie uma nova integração e preencha os seguintes campos:

• Nome: nome da sua integração (você pode alterar essa informação depois);
• Assistente: selecione o assistente que deseja integrar ao Telegram;
• Squads: selecione o nome da squad, se estiver disponível na lista. Caso contrário, mantenha como “geral”;
• Organization ID: essa informação está na etapa anterior deste artigo;
• Sender ID: essa informação está no App Zenvia, em Meu Menu > Integrações > WhatsApp.
• Ao encontrar na lista a conta que deseja vincular seu assistente, clique em Copiar Sender ID e use-a nesse campo;

Webhook de status

Um webhook é uma infraestrutura que recebe informações sobre as mensagens de outbound enviadas. Ele é composto por um endpoint (link do webhook, onde o cliente receberá as atualizações de status) e um token (acesso gerado pela equipe Zenvia NLU para realizar a integração).

Você vai precisar das seguintes informações, que são encontradas logo abaixo da área de configuração da API de outbound:

• Header: token gerado pelo Zenvia NLU, que é específico para cada assistente e canal.
• Post: link com o endpoint informado para acesso.

Exemplos de retorno:

Exemplo 1:

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

Exemplo 2:

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

Exemplo 3:

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

Exemplo 4:

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

Exemplo 5:

{
"external_id": "d0cbd762-3690-4c28-ad71-14b572544bb1",
"status": "replied",
"destination": "destination",
"date": "2023-10-04T17:07:25-03:00",
"client": "slug",
"reply": "Olá!"// texto respondido pela pessoa
}