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: 1. API de nuvem do WhatsApp 2. Twilio Explicaremos todos os procedimentos neste guia. ### **Pré-requisitos** 1. Você precisa de uma [**Meta conta de desenvolvedor**](https://developers.facebook.com/) para configurar a API do WhatsApp. Se você ainda não tem uma conta de desenvolvedor, clique [**aqui**](https://business.facebook.com/business/loginpage/) para criar uma antes de continuar 2. Um número de telefone válido ## **Usando API do WhatsApp Cloud** [**WhatsApp Cloud API**](https://developers.facebook.com/docs/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**](https://www.facebook.com/business/partner-directory/search?solution_type=messaging)) 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**](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/**](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**](https://business.facebook.com/settings). 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](/hc/ajuda/articles/como-usar-templates-de-whatsapp). **Quais são os tipos de mídia suportados?** --- ## Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. 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.