Principal Caixas de Entrada Como configurar um canal WhatsApp?

Como configurar um canal WhatsApp?

Última atualização em Feb 05, 2025

Você pode gerenciar as conversas da sua conta comercial do WhatsApp no FalAIChat.

Para configurá-lo, você tem três opções de provedor:

API de Nuvem do WhatsApp
Twilio
360Dialog

📌 Neste guia, explicaremos como configurar usando a API do WhatsApp Cloud.


Pré-requisitos

Antes de configurar sua caixa de entrada do WhatsApp no FalAIChat, você precisará realizar algumas etapas no provedor de API escolhido.

Se estiver usando a API do WhatsApp Cloud, siga os pré-requisitos abaixo.


Usando a API do WhatsApp Cloud

I. Configure seu aplicativo

1️⃣ Crie um aplicativo de desenvolvedor do Facebook com o WhatsApp Product habilitado.
2️⃣ Acesse o Guia da API do WhatsApp Cloud e siga as instruções da seção "Set up Developer Assets and Platform Access".
3️⃣ Após concluir essa etapa, configure os números de telefone necessários na seção WhatsApp do seu aplicativo no Facebook Developer.
4️⃣ Se configurado corretamente, você obterá o Phone Number ID e o WhatsApp Business Account ID.

📌 O FalAIChat precisará desses valores para criar a caixa de entrada do WhatsApp.


II. Configure um usuário do sistema no Facebook Business Manager

Para gerar um token de acesso (API Key), siga estes passos:

1️⃣ No Facebook Business Manager, vá para a aba Usuários do Sistema e crie um usuário do sistema.
2️⃣ Na aba Contas do WhatsApp, clique em "Adicionar Pessoas" e selecione o usuário do sistema para conceder acesso.
3️⃣ Gere o token de acesso e conceda as permissões necessárias:

  • whatsapp_business_management

  • whatsapp_business_messaging

📌 Esse token será usado para configurar a caixa de entrada no FalAIChat.

🔹 Para mais detalhes, veja este vídeo tutorial aqui.


Usando a API do Twilio

Se você planeja usar Twilio, siga estes pré-requisitos:

1️⃣ No console do Twilio, vá para Programmable SMS → WhatsApp → Senders.
2️⃣ Clique no seu número de telefone.
3️⃣ No campo "WHEN A MESSAGE COMES IN", insira este URL:

arduinoCopyEdithttps://app.falaichat.com/twilio/callback

Isso permitirá que o FalAIChat receba mensagens do Twilio.


Twilio Studio

📌 Se você estiver usando um fluxo de conversação no Twilio Studio, não altere diretamente o webhook, pois isso pode interromper a integração.

Em vez disso, adicione um widget "Make HTTP Request" com os seguintes valores:

  • Método: POST

  • URL: https://app.falaichat.com/twilio/callback

  • Content-Type: application/json

  • Request Body: {{trigger.message | to_json }}

🎯 Isso permitirá que as mensagens do Twilio sejam encaminhadas para o FalAIChat.


Configurando a caixa de entrada do WhatsApp no FalAIChat

📌 Se você já atendeu aos pré-requisitos, siga as etapas abaixo para configurar sua caixa de entrada do WhatsApp no FalAIChat.

Passo 1. Criar uma nova caixa de entrada

1️⃣ No painel do FalAIChat, vá para Configurações → Caixas de Entrada → Adicionar Caixa de Entrada.
2️⃣ Clique no ícone "WhatsApp".
3️⃣ Escolha um provedor de API (WhatsApp Cloud, Twilio ou 360Dialog).


Passo 2. Selecionando a API do WhatsApp Cloud

📌 Escolha "WhatsApp Cloud" como o provedor de API.

Agora você precisará configurar seu Webhook Callback URL.


Passo 3. Configurar o Webhook do WhatsApp no Facebook Developer

1️⃣ No Facebook Developer, acesse a seção WhatsApp do seu aplicativo.
2️⃣ Vá até Configuration e configure o campo Callback URL.

📌 O URL deve ter este formato:

rubyCopyEdithttps://app.falaichat.com/webhooks/whatsapp/+{phone_number}

📌 O token de verificação deve ser o mesmo definido no FalAIChat ao criar a caixa de entrada.

3️⃣ Habilite eventos de mensagem na seção Webhooks Fields do Facebook Developer.
4️⃣ Após concluir essa configuração, a tela do Facebook Developer deve exibir a integração concluída.


Selecionando Twilio

📌 Escolha "Twilio" como provedor de API e preencha os campos obrigatórios.
📌 Clique em "Criar Canal Twilio".


Selecionando 360Dialog

📌 Escolha "360Dialog" como provedor de API.
📌 Após concluir a configuração, adicione os agentes à sua caixa de entrada.


Passo 4. Adicionar agentes à sua caixa de entrada

📌 Agora que sua caixa de entrada do WhatsApp foi criada, adicione agentes que irão responder às conversas.

Você criou com sucesso uma caixa de entrada do WhatsApp no FalAIChat!


Configurações adicionais da Caixa de Entrada do WhatsApp

📌 Para visualizar e ajustar configurações adicionais:
✅ Vá para Configurações → Caixas de Entrada.
✅ Clique no ícone de engrenagem ⚙️ ao lado da caixa de entrada do WhatsApp.


Tipos de mídia suportados

Sua caixa de entrada do WhatsApp no FalAIChat suporta vários tipos de mídia.

Áudio
📌 Formatos suportados: aac, mp4, mpeg, amr, oga

Documentos
📌 Formatos suportados:

  • text/plain

  • application/pdf

  • application/msword

  • application/vnd.ms-excel

  • application/vnd.openxmlformats-officedocument.wordprocessingml.document

Imagens
📌 Formatos suportados: jpeg, png

Vídeos
📌 Formatos suportados: mp4, 3gp

Stickers
📌 Formato suportado: imagem/webp (somente para o usuário final).


Perguntas Frequentes

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

📌 O Facebook permite configurar apenas um Webhook por aplicativo.

Se você precisar conectar vários números de WhatsApp:
1️⃣ Crie caixas de entrada separadas no FalAIChat para cada número.
2️⃣ Configure o Webhook URL para apenas uma dessas caixas de entrada no Facebook.

🚀 Agora você está pronto para gerenciar o WhatsApp no FalAIChat!