WhatsApp Cloud API

Você pode gerenciar as conversas da sua conta comercial do WhatsApp a partir do Messages. Para configurá-lo, você tem duas opções para escolher seu provedor:

1. API do WhatsApp Cloud

2. Twilio

Explicaremos todos os procedimentos neste guia.

Pré-requisitos 

Antes de trazer sua caixa de entrada do WhatsApp para o Messages, você precisa configurar algumas coisas no provedor de API que deseja usar. Esses pré-requisitos são explicados abaixo.

Usando a API do WhatsApp Cloud 

Se você planeja usar a API do WhatsApp Cloud, os dois pré-requisitos a seguir são necessários.

1. Configure seu aplicativo

Primeiro, você precisa criar seu aplicativo Facebook Developer com  WhatsApp Product habilitado. Vá para o  WhatsApp Cloud API Guide  e navegue até a seção chamada  Set up Developer Assets and Platform Access e siga os passos.

Após concluir esta etapa, você pode configurar seus números de telefone necessários na  WhatsApp seção do seu aplicativo de desenvolvedor do Facebook. Se você concluir as etapas com sucesso, você deve conseguir obter o  Phone Number Id e  Whatsapp Bussiness Account ID, conforme mostrado na captura de tela abaixo. O Messages exigirá esses valores para criar a Caixa de entrada do WhatsApp.

2. Configure um usuário do sistema para o seu Facebook Business Manager

Crie  um usuário do sistema no seu Business Manager com acesso ao WhatsApp App. Gere um token de acesso para o usuário, que será necessário como a chave de API para configurar uma caixa de entrada no Messages.

Ao gerar o token de acesso, certifique-se de que as   permissões whatsapp_business_management e  estejam selecionadas.whatsapp_business_messaging

Etapa 1.  Crie um usuário do sistema na guia Usuários do Sistema do Business Manager.

Etapa 2.  Adicione o usuário do sistema. Na aba Contas do WhatsApp, selecione “Adicionar Pessoas” e selecione o usuário do sistema para conceder acesso à conta do WhatsApp Business.

Etapa 3. Gere o token de acesso e solicite permissões.

Veja este vídeo  para obter etapas detalhadas.

 

Usando Twilio 

Se você planeja usar a API da Twilio, os seguintes pré-requisitos são necessários.

Para se conectar a uma  caixa de entrada do WhatsApp  , você precisará configurar uma URL de retorno de chamada na caixa de entrada do Twilio. Siga os passos abaixo.

1. Faça login no seu console Twilio.

2. Vá para  Programmable SMS -> Whatsapp -> Senders.

3. Você poderá ver seu número de telefone. Clique nele.

4. Forneça  https://omni.hellocloud.com.br/twilio/callback como valor para  WHEN A MESSAGE COMES IN entrada.

Twilio Studio

Se você usar o Twilio Studio para um fluxo de conversação personalizado, atualizar o URL do webhook diretamente interromperá sua integração existente.

Para esses casos, você pode seguir os passos abaixo.

1. 1. Identifique a etapa do seu fluxo onde você quer que isso  agent handoff aconteça.

   2. Adicione um  make http request widget como mostrado abaixo com os valores fornecidos.

      MÉTODO DE SOLICITAÇÃO  : POST

      URL DE SOLICITAÇÃO :  https://omni.hellocloud.com.br/twilio/callback

      TIPO DE CONTEÚDO : Aplicação/JSON

      CORPO DA SOLICITAÇÃO :  {{trigger.message | to_json }} (faça as alterações necessárias com base nas suas variáveis ​​de fluxo).

      O widget de solicitação HTTP encaminhará o corpo da mensagem para o Messages. Isso criará uma conversa no Messages de onde o agente pode responder.

       

   3. Certifique-se de que seu fluxo pode lidar com as respostas do usuário às Respostas do Agente.

Configurando a caixa de entrada do WhatsApp no ​​Messages 

Se seus pré-requisitos forem atendidos, você pode criar sua caixa de entrada do WhatsApp no ​​Messages. Siga os passos descritos abaixo.

Etapa 1.  Abra seu painel do Messages. Vá para Configurações → Caixas de entrada → Adicionar caixa de entrada.

Etapa 2.  Clique no ícone "WhatsApp".

Etapa 3.  Escolha um provedor de API. Com base na sua seleção, você verá um conjunto diferente de campos a serem preenchidos. Vamos aprender sobre cada um deles.

Selecionando a API do WhatsApp Cloud

Escolha "WhatsApp Cloud" como provedor de API.

Conclua os passos para obter seu Whatsapp  Webhook Callback URL.

Habilitar o webhook

Configure o webhook no aplicativo do desenvolvedor do Facebook.

Volte para a  WhatsApp seção no aplicativo do desenvolvedor do Facebook. Navegue até a  Configuration subseção e configure o  Callback URL.

• O valor da URL deve ser o mesmo URL obtido no final da criação da caixa de entrada do Messages e terá a seguinte aparência  https://omni.hellocloud.com.br/webhooks/whatsapp/+{phone_number}:

• O valor para  verify token deve ser o mesmo valor que você configurou para  Webhook Verify Token durante a criação da caixa de entrada.

Você  também deve assinar os eventos do campo de mensagem  no seu aplicativo do Facebook Developer em Campos de Webhooks.

 

Configurações adicionais da caixa de entrada 

Sua caixa de entrada do WhatsApp recém-configurada deve aparecer agora na sua lista de caixas de entrada. Para ver isso e fazer configurações adicionais na sua caixa de entrada do WhatsApp, vá para Configurações → Caixas de entrada → clique no ícone de engrenagem na caixa de entrada do WhatsApp associada.

Tipos de mídia suportados 

Sua caixa de entrada do WhatsApp suporta vários tipos de mídia, conforme resumido abaixo.

Áudio 

Extensões suportadas :

• AAC-A

• mp4

• MPEG-4

• amr

• ogg

Suportado por : Usuário final e agente no Messages

Documento 

Extensões suportadas :

• texto/simples

• aplicação/pdf

• aplicação/vnd.ms-powerpoint

• aplicação/msword

• aplicação/vnd.ms-excel

• aplicação/vnd.openxmlformats-officedocument.wordprocessingml.document

• aplicação/vnd.openxmlformats-officedocument.presentationml.presentation

• aplicação/vnd.openxmlformats-officedocument.spreadsheetml.sheet

Suportado por : Usuário final e agente no Messages

Imagem 

Extensões suportadas :

• jpeg

• png

Suportado por : Usuário final e agente no Messages

Vídeo 

Extensões suportadas :

• mp4

• 3gp

Suportado para : mp4 para o usuário final e o agente no Messages, e 3gp somente para o usuário final.

Adesivo 

Extensões suportadas : image/webp

Suportado para : Somente usuário final

Perguntas frequentes 

Como configurar vários números em um único aplicativo do Facebook ?

O aplicativo do Facebook permite configurar apenas um único ponto de extremidade do Webhook. Então, crie caixas de entrada no Messages para todos os números, conforme necessário. Você precisará configurar a URL do Webhook fornecida para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras caixas de entrada funcionem.

Que tipos de modelos do Whatsapp são suportados pelo Messages?

No momento, o Messages suporta apenas modelos baseados em texto. Se seu modelo tiver cabeçalhos de mídia ou componentes personalizados como botões, formulários, etc., eles não serão exibidos no seletor de modelos do Messages.