![Fluxo para configurar o WhatsApp via Meta Cloud: criar o aplicativo e o token, verificar o número, escolher Cloud do WhatsApp, usar a configuração rápida ou o fluxo manual e configurar o webhook.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3NSIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--37d67bd0e5b189f1839efd4f82567b2a0511b0ff/1715702509-como-configurar-um-canal-whats_app.png) A API oficial do WhatsApp — a **Meta Cloud API** — serve a um propósito específico na plataforma: enviar **templates de mensagem** aprovados pela Meta e disparar **campanhas**, ou seja, mensagens proativas e mensagens fora da janela de atendimento de 24 horas. Para o atendimento do dia a dia (conversas de mão dupla iniciadas pelo cliente), o canal recomendado é o **WhatsApp Web**, que conecta por QR Code e não exige credenciais do Meta Business. Use a API oficial apenas quando precisar alcançar o cliente primeiro. Veja [Conectar o WhatsApp Web (QR Code)](1724618803-como-configurar-um-canal-whats_app-usando-a-evolution-api). > Um mesmo número não pode usar os dois métodos ao mesmo tempo: WhatsApp Web e Meta Cloud API são formas de conexão diferentes. Escolha uma por número. ## Quando usar cada método - **Templates de mensagem e campanhas** (mensagens proativas, notificações, retomada de contato fora das 24h): **Meta Cloud API (API oficial)**. Os templates precisam ser aprovados pela Meta antes do envio. - **Atendimento diário de mão dupla** (o cliente inicia a conversa): **WhatsApp Web**. Veja [Conectar o WhatsApp Web (QR Code)](1724618803-como-configurar-um-canal-whats_app-usando-a-evolution-api). ## Antes de começar Para usar a API oficial você precisa providenciar, do lado da Meta: 1. Uma **conta de desenvolvedor Meta** ([developers.facebook.com](https://developers.facebook.com/)) e uma **conta Meta Business** ativa. 2. Um **número de telefone válido**, pronto para produção e que ainda não esteja em uso no WhatsApp Web. Como a Cloud API é hospedada na própria infraestrutura da Meta, você não precisa de provedores terceirizados para hospedar sua API do WhatsApp Business. Os passos abaixo são feitos no painel da Meta; consulte o [guia oficial para começar com o WhatsApp](https://developers.facebook.com/documentation/business-messaging/whatsapp/get-started?locale=pt_BR) se alguma tela do console deles mudar. Este artigo cobre onde a API oficial se conecta à plataforma. ## Configuração ### Passo 1: Criar o portfólio de negócios Crie um perfil comercial com o nome, a descrição e as informações de contato da sua empresa — um perfil bem elaborado ajuda os clientes a reconhecer e confiar na sua marca. Entre em [business.facebook.com](https://business.facebook.com/) e, no menu **Início**, clique em **Criar portfólio**. Preencha todos os campos obrigatórios. ### Passo 2: Criar o aplicativo do Facebook Entre em [developers.facebook.com](https://developers.facebook.com/) e clique em **Criar aplicativo**. Preencha os campos obrigatórios, escolha o tipo **Negócios** e selecione o seu portfólio de negócios no menu suspenso. ### Passo 3: Adicionar o produto WhatsApp No painel do aplicativo, clique em **Adicionar produto** e escolha **WhatsApp** na lista, clicando em **Configurar**. > **Observação:** antes de prosseguir, verifique sua empresa com a Meta. É preciso enviar a documentação para verificação, necessária para o acesso total à API. ### Passo 4: Gerar um token de acesso permanente Para manter o acesso seguro e ininterrupto, crie um **usuário do sistema** e gere um token permanente. 1. Nas **Configurações comerciais** ([business.facebook.com/settings](https://business.facebook.com/settings)), clique em **Usuários do sistema** e adicione um novo usuário com a função **Admin**. 2. Clique em **Adicionar ativos**, selecione o nome do seu aplicativo, escolha **Controle total** e clique em **Atribuir ativos**. 3. Volte a **Usuários do sistema**, selecione o usuário recém-criado e clique em **Gerar novo token**. 4. Selecione o seu aplicativo no menu suspenso e conceda as permissões de **mensagens** e de **gerenciamento** do WhatsApp Business (`whatsapp_business_messaging` e `whatsapp_business_management`), além da permissão de eventos do WhatsApp Business. 5. **Copie e guarde o token** — ele é exibido apenas uma vez. ### Passo 5: Configurar a Cloud API e o número Selecione **Criar uma conta empresarial** (ou escolha uma existente), clique em **Continuar** e adicione o seu **número de telefone** pronto para produção. > **Observação:** a Meta exige um número verificado. Você pode verificá-lo por meio de uma senha de uso único (OTP) enviada ao número. ### Passo 6: Conectar a caixa de entrada da API oficial Com a Cloud API configurada, copie o **ID do número de telefone** e o **ID da conta comercial** exibidos no painel da Meta. Em seguida, na plataforma: 1. Acesse **Configurações → Caixas de Entrada → Adicionar caixa de entrada**. 2. Escolha **WhatsApp** e selecione **Cloud do WhatsApp**. 3. Se a tela **Configuração rápida com Meta** aparecer, clique em **fluxo de configuração manual** para usar as credenciais deste guia. Como alternativa, você pode concluir a configuração rápida entrando na Meta e seguindo o assistente. 4. No fluxo manual, informe o **número de telefone**, o **ID do número de telefone** e o **ID da conta comercial** obtidos na Meta. 5. Em **Chave de API**, cole o token permanente gerado no Passo 4. 6. Use **Adicionar agentes** para incluir os agentes que vão atender esta caixa de entrada. 7. Conclua a criação. A plataforma exibirá uma **URL de webhook** e um **token de verificação** — copie os dois para o próximo passo. ### Passo 7: Configurar o webhook O webhook permite que as mensagens enviadas ao seu número comercial cheguem à plataforma. 1. Na conta de desenvolvedor, vá em **WhatsApp → Configuração**. 2. Cole a **URL de webhook** e o **token de verificação** copiados no passo anterior e clique em **Verificar e salvar**. 3. Nas permissões do webhook, **assine** o campo **mensagens** (`messages`). Pronto! A caixa de entrada da API oficial está conectada. ## Templates de mensagem e campanhas Depois que a caixa da API oficial estiver conectada, os **templates de mensagem** aprovados pela Meta ficam disponíveis para envio, e você pode usá-los em **campanhas** para alcançar contatos de forma proativa ou fora da janela de 24 horas. Lembre-se: novos templates precisam ser criados e aprovados pela Meta antes de aparecerem para uso. ## Perguntas frequentes **Como configurar vários números em um único aplicativo do Facebook?** O aplicativo do Facebook permite apenas um endpoint de webhook. Crie uma caixa de entrada na plataforma para cada número necessário, mas configure a URL de webhook em apenas uma delas no aplicativo do Facebook — as demais caixas de entrada funcionarão a partir dessa mesma configuração. **Que tipos de template são suportados?** O seletor trabalha com os templates aprovados e devolvidos pela Meta, incluindo texto e os componentes compatíveis exibidos na prévia, como cabeçalhos de mídia e botões. A disponibilidade de cada componente depende da categoria e da estrutura aprovadas pela Meta; faça um envio de teste antes de programar uma campanha ampla. ## Artigos relacionados - [Conectar o WhatsApp Web (QR Code)](1724618803-como-configurar-um-canal-whats_app-usando-a-evolution-api) — o canal do dia a dia para atendimento de mão dupla, sem credenciais do Meta Business.