![Visão geral do fluxo manual do WhatsApp Cloud API: criar o aplicativo Meta com token permanente, verificar o número de telefone, criar a caixa de entrada com os IDs do número e do negócio e ativar o webhook.](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBajRTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a016ff9c2c808a3210067ed3b46a8625f84d7b66/1784046115-como-configurar-um-canal-do-whats_app-fluxo-manual.png)

Você pode gerenciar as conversas da sua conta empresarial do WhatsApp pela plataforma, conectando a **WhatsApp Cloud API** da Meta pelo fluxo manual. Este guia detalha cada etapa; para a visão geral do canal — incluindo templates e campanhas — veja [WhatsApp via API oficial (Meta Cloud)](1715702509-como-configurar-um-canal-whats_app).

### **Pré-requisitos**

1. Você precisa de uma [**Conta de Desenvolvedor Meta**](https://developers.facebook.com/) para configurar a API do WhatsApp. Se ainda não tem uma conta de desenvolvedor, clique [**aqui**](https://business.facebook.com/business/loginpage/) para criar uma antes de prosseguir.

2. Um número de telefone válido

## **Usando o Whatsapp Cloud API**

O [**WhatsApp Cloud API**](https://developers.facebook.com/docs/whatsapp/cloud-api/) está disponível para todas as empresas e desenvolvedores individuais. Como é hospedado na infraestrutura em nuvem da 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 seu Perfil Empresarial**

Crie um perfil profissional do WhatsApp Business com o nome da sua empresa, descrição e informações de contato. Um perfil bem elaborado ajuda os clientes a reconhecerem e confiarem na sua marca ao interagir 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 "Início"

![Meta Business Suite com o menu Início aberto e o botão de criar portfólio em destaque](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2NTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5cd3518eb43a08a739977fe5cf3ed7b71ba85ea2/wa-manual-01.png)

Preencha todos os campos obrigatórios para configurar seu portfólio empresarial.

![Formulário de criação do portfólio empresarial na Meta com os campos obrigatórios](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2dTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--09b08ee82d673418c739e0a7912005e298512006/wa-manual-02.png)

Depois de criar seu portfólio empresarial, é 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**.

![Painel de desenvolvedor da Meta com o botão Criar Aplicativo em destaque](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2tTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ca54fa7ca14a3e0df76c39707320b6c98b6ca10d/wa-manual-03.png)

Preencha os campos obrigatórios

![Formulário de detalhes do aplicativo com os campos obrigatórios preenchidos](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa29TIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1628f1d21cf1d820dfa9cbec44c93748a4018cb1/wa-manual-04.png)

Clique em "Outro" entre as opções

![Seleção de caso de uso do aplicativo com a opção Outro marcada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3NTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d4553766d5b2f044b5fb31dd77cd8186adc85ff6/wa-manual-05.png)

Escolha "Business" como o tipo do seu aplicativo

![Seleção do tipo de aplicativo com a opção Business marcada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3dTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--efd9a925550572b9172dfbad50a7b5da3bf54894/wa-manual-06.png)

Digite seu e-mail de contato e selecione seu portfólio empresarial no menu suspenso.

![Formulário final de criação do aplicativo com e-mail de contato e portfólio empresarial selecionados](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazBTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c32017af5dd953f8f3ac766ae7f84262be9d1370/wa-manual-07.png)

## **Adicionar Whatsapp ao seu aplicativo**

Após criar seu aplicativo, você será direcionado ao painel do aplicativo. Lá, clique em **"Adicionar Produto"** e escolha **WhatsApp** na lista de produtos disponíveis.

Clique no botão "Configurar" para o WhatsApp

![Painel do aplicativo com o produto WhatsApp e o botão Configurar em destaque](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazRTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--75bbafb1edacc80f09cda66b9192aac9ea805267/wa-manual-08.png)

***Nota:** Antes de prosseguir, verifique sua empresa com a Meta. Você precisará enviar documentação para verificação, o que é obrigatório para acesso completo à API.*

## **Configure um Token de Acesso Permanente para o WhatsApp Cloud API**

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

Faça login na sua conta de desenvolvedor do Facebook, selecione seu aplicativo do WhatsApp e vá até a [**página de configurações do negócio**](https://business.facebook.com/settings).

Clique em "Usuários do sistema" e adicione um novo usuário do sistema com o papel **Admin**

![Configurações do negócio na Meta, seção Usuários do sistema, criando um usuário com papel Admin](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBazhTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--f674cb46946b47e8fe815693368767920530268b/wa-manual-09.png)

Clique no botão "Adicionar Ativos", selecione o nome do seu aplicativo, escolha a opção "Controle Total" e clique em "Atribuir ativos."

![Janela Atribuir ativos com o aplicativo selecionado e a opção de controle total ativada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbEFTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c9b808e081735c1420a821f0f6189cb2ca2fa67c/wa-manual-10.png)

Volte para a página de **usuários do sistema**, selecione seu novo usuário na lista e clique no botão "**Gerar novo token**".

![Página de usuários do sistema com o botão Gerar novo token em destaque](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbEVTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--50a43a080d284da11a6d8199deaab61ed59643a6/wa-manual-11.png)

Selecione seu aplicativo no menu suspenso

![Janela de geração de token com o aplicativo selecionado no menu suspenso](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbElTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b8eb4897ce28c4e7a1b09e51d1c42a2db1a48c9c/wa-manual-12.png)

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

* whatsapp_business_manage_events

* whatsapp_business_management

* whatsapp_business_messaging

![Lista de permissões do token com as três permissões do WhatsApp Business marcadas](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbE1TIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--5e5f3e35cb90c33a6e7622f31b1b9aeecb13e72c/wa-manual-13.png)

Copie e salve seu token

![Janela exibindo o token de acesso gerado com o botão de copiar](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbFFTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--da582ea93583529f1f223e08b9c366eb913a4ae7/wa-manual-14.png)

## **Configure o WhatsApp Cloud API**

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 nas opções existentes. Estou selecionando "**criar uma conta empresarial**". Clique no botão ***continuar***.

![Configuração da Cloud API com a opção de criar uma conta empresarial selecionada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbFVTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--12abb673b94e6c0ed633d8ea5991d3f7d12e4edb/wa-manual-15.png)

Cole seu token permanente aqui

![Campo para colar o token de acesso permanente na configuração da Cloud API](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbFlTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--49db886c6cb0e5b1135bc57027b392c4727f9917/wa-manual-16.png)

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

![Tela para adicionar o número de telefone de produção do WhatsApp](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbGNTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b0ba03010be29ffd93933abed68b6ff6afc74497/wa-manual-17.png)

*Nota*: A Meta exige um número de telefone verificado para a configuração da API do WhatsApp. Você pode verificar seu número usando um OTP (senha única).

![Tela de verificação do número de telefone por código OTP](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbGdTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ce3d9483864e6908a25dce07ff3c63eadd6257a7/wa-manual-18.png)

Depois de adicionar e verificar seu número de telefone, o próximo passo é configurar um webhook para receber mensagens recebidas.

## **Conectando sua Conta**

Vamos conectar sua conta da plataforma à sua Cloud API do WhatsApp

Copie seu WhatsApp Phone Number ID e Business Account ID nesta seção

![Painel da API do WhatsApp exibindo o Phone Number ID e o Business Account ID](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbGtTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a0c7ced8400acc177551a8a14dc4a4a62a67951c/wa-manual-19.png)

Faça login na sua conta, vá em Configurações > Caixa de Entrada e selecione o canal WhatsApp

![Criação de caixa de entrada na plataforma com o canal WhatsApp selecionado](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbG9TIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--7915cc04b65b34d29e05ad56650f3d265f4ca885/wa-manual-20.png)

Informe seu número de telefone, phone number ID e business ID do seu setup do WhatsApp API

![Formulário da caixa de entrada com número de telefone, Phone Number ID e Business Account ID](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbHNTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--ba997aabf8ca2488e9de51fb42f3db2645330038/wa-manual-21.png)

Adicione membros da equipe à sua caixa de entrada do WhatsApp

![Tela de seleção de agentes para a nova caixa de entrada do WhatsApp](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbHdTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d8b119b11d0dc4e513a6fce99c156aeedcdce18f/wa-manual-22.png)

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

![Tela final da criação da caixa de entrada exibindo a URL de webhook e o token de verificação](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbDBTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--df7d27b1103000a3da9721b73041966933dbfa00/wa-manual-23.png)

## **Configure seu Webhook**

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

Use exatamente a **URL de webhook** e o **token de verificação** que a plataforma exibiu na criação da caixa de entrada (passo anterior).

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

Cole sua URL do webhook e o token de verificação aqui, depois clique em "Verificar e Salvar"

![Configuração do webhook no aplicativo Meta com os campos de URL de callback e token de verificação](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbDRTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d506b63b5f3a022fb95f07d63aaf2d503625a2e3/wa-manual-24.png)

Configure permissões do webhook assinando mensagens

![Campos de webhook do WhatsApp com a assinatura do campo de mensagens ativada](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbDhTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0cd45991c7fa646c87552b4c61162917aa13d21a/wa-manual-25.png)

Pronto—tudo certo! Agora você já pode começar a enviar mensagens do WhatsApp pela plataforma.

### **Perguntas Frequentes**

**Como configurar múltiplos números em um único aplicativo do Facebook?**

O aplicativo do Facebook permite configurar apenas um endpoint de Webhook. Portanto, crie Caixas de Entrada para todos os números necessários. Você precisará configurar a URL do Webhook fornecida para apenas uma dessas caixas de entrada no aplicativo do Facebook para que todas as outras funcionem.

**Que tipo de modelos de Whatsapp são suportados?**

Confira a seção de templates em [WhatsApp via API oficial (Meta Cloud)](1715702509-como-configurar-um-canal-whats_app) para mais detalhes sobre modelos.

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

![Tabela dos tipos de mídia suportados pelo canal WhatsApp, com formatos e limites de tamanho](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBbUFTIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--a0f0a5a787602ff4df5c745c81f6cbbaf0ee4f11/wa-manual-26.png)