Como configurar WhatsApp API oficial manualmente

Use este guia quando você precisar configurar, entender ou validar Como configurar WhatsApp API oficial manualmente na IAra.

Antes de começar na IAra

Confirme que seu usuário tem permissão para acessar a área citada no artigo.
Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

Guia detalhado

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

API de nuvem do WhatsApp
Twilio

Explicaremos todos os procedimentos neste guia.

Pré-requisitos

Você precisa de uma Meta conta de desenvolvedor para configurar a API do WhatsApp. Se você ainda não tem uma conta de desenvolvedor, clique aqui para criar uma antes de continuar
Um número de telefone válido

Usando API do WhatsApp Cloud

WhatsApp Cloud API está disponível para todas as empresas e desenvolvedores individuais. Como ele está hospedado na infraestrutura de nuvem do Meta, você não precisa mais usar provedores terceirizados como Twilio, Zendesk, 360Dialog ou MessageBird (Business Solution Providers) para hospedar sua API do WhatsApp Business.

Configure o perfil da sua empresa

Crie um perfil comercial profissional no WhatsApp com o nome da sua empresa, descrição e informações de contato. Um perfil bem elaborado ajuda os clientes a reconhecer e confiar em sua marca quando interagem com você.

Faça login em https://business.facebook.com e clique no botão criar portfólio no menu suspenso em Página inicial

Preencha todos os campos obrigatórios para configurar seu portfólio de negócios.

Depois de criar seu portfólio de negócios, é hora de criar seu aplicativo do Facebook.

Configure seu aplicativo do Facebook

Faça login em https://developers.facebook.com/ e clique no botão Criar aplicativo.

Preencha os campos obrigatórios

Clique em "Outro" nas opções

Escolha "Comercial" como seu tipo de aplicativo

Digite seu endereço de e-mail de contato e escolha seu portfólio de negócios no menu suspenso.

Adicione o WhatsApp ao seu aplicativo

Depois de criar seu aplicativo, você será direcionado para o painel do aplicativo. A partir daí, clique em "Adicionar Produto" e escolha WhatsApp na lista de produtos disponíveis.

Clique no botão "Configurar" do WhatsApp

Observação: Antes de continuar, verifique sua empresa com Meta. Você precisará enviar documentação para verificação, que é necessária para acesso completo à API.

Configurar um token de acesso permanente à API do WhatsApp Cloud

Você precisará criar um Usuário do sistema e gerar um token permanente para manter acesso seguro e ininterrupto.

Faça login em sua conta de desenvolvedor do Facebook, selecione seu aplicativo WhatsApp e navegue até a página de configurações empresariais.

Clique em "Usuários do sistema" e adicione um novo usuário do sistema com a função Admin

Clique no botão “Adicionar ativos”, selecione o nome do seu aplicativo, escolha a opção “Controle total” e clique em “Atribuir ativos”.

Retorne à página usuários do sistema, selecione o usuário do sistema recém-criado na lista e clique no botão "Gerar novo token".

Selecione seu aplicativo no menu suspenso

Selecione estes três níveis de permissão para seu token:

*whatsapp_business_manage_events

*whatsapp_business_management

*whatsapp_business_messaging

Copie e salve seu token

Configurar a API do WhatsApp Cloud

Para criar uma nova conta empresarial Meta, selecione "criar uma conta empresarial" no menu suspenso. Se você já possui uma conta empresarial, pode selecioná-la entre as opções existentes. Estou selecionando "criar uma conta comercial". Clique no botão continuar.

Cole seu token permanente aqui

Adicione seu número de telefone pronto para produção

Depois de adicionar e verificar seu número de telefone, a próxima etapa é configurar um webhook para receber mensagens recebidas.

Conectando sua conta da IAra

Vamos conectar sua conta da IAra com sua API WhatsApp Cloud

Copie o ID do seu número de telefone do WhatsApp e o ID da conta comercial desta seção

Faça login em sua conta da IAra, vá em Configurações > Caixa de entrada e selecione Canal WhatsApp

Insira seu número de telefone, ID do número de telefone e ID comercial na configuração da API do WhatsApp

Adicione membros da equipe à sua caixa de entrada do WhatsApp

Copie o URL do webhook e o token de verificação do webhook fornecidos aqui

Configure seu webhook

Precisamos configurar o webhook do WhatsApp para receber mensagens de clientes enviadas para o seu número comercial.

Seu URL de retorno de chamada deve seguir o formato exibido pela própria IAra na configuração da caixa de entrada, por exemplo https://app.digi2b.com/webhooks/WhatsApp/{phone_number}.

Faça login em sua conta de desenvolvedor do Facebook e navegue até WhatsApp > Configuração

Cole o URL do webhook da IAra e o token de verificação aqui e clique em "Verificar e salvar"

Configure permissões de webhook assinando mensagens

É isso aí, está tudo pronto! Agora você pode começar a enviar mensagens do WhatsApp através da IAra.

Perguntas frequentes

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

O aplicativo do Facebook permite configurar apenas um único endpoint Webhook. Portanto, crie caixas de entrada na IAra para todos os números conforme necessário. Você precisará configurar o URL do Webhook fornecido para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras caixas de entrada funcionem.

Que tipo de modelos do WhatsApp são suportados pela IAra?

Para detalhes sobre modelos, veja Como usar templates de WhatsApp.

Quais são os tipos de mídia suportados?

Como validar na IAra

Execute o fluxo em uma conta ou conversa de teste.
Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

Problemas comuns

Usuário sem permissão para acessar a configuração.
Nome de tela diferente entre versões ou contas.
Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
Falta de teste em conversa realista antes de liberar para a equipe.

Checklist final

[ ] Configuração revisada por um administrador.
[ ] Teste realizado com dado ou conversa controlada.
[ ] Impacto para agentes e gestores entendido.
[ ] Artigos relacionados revisados para evitar links quebrados.