Introdução à API de Nuvem do WhatsApp

1. Você precisa ter uma conta do Facebook ou uma conta gerenciada da Meta.
2. É necessário se registrar como desenvolvedor.
   • Caso ainda não tenha se inscrito como desenvolvedor, acesse https://developers.facebook.com/async/registration/ e siga as instruções.
3. Você precisa de acesso a um dispositivo com o WhatsApp instalado para enviar e receber mensagens de teste durante a configuração.

1. Selecione o app existente no Painel de Apps.
2. Clique em Adicionar casos de uso.
3. Selecione Conectar-se com clientes pelo WhatsApp e siga as instruções para adicionar o caso de uso ao seu app.
   • Observação: se não tiver um portfólio empresarial da Meta, você criará um durante esse processo.

1. Siga as instruções no Painel de Apps para criar um novo app.
   • Selecione o caso de uso Conectar-se com clientes pelo WhatsApp.
   • Selecione um portfólio empresarial existente ou siga as instruções para criar um novo.
   • Termine de criar o app.
2. Após a criação do app, selecione Casos de uso (ícone de lápis) na barra lateral.

1. Navegue até o Painel de Apps e selecione o app.
2. Clique em Casos de uso (ícone de lápis) na barra lateral.
3. No caso de uso Conectar-se com clientes pelo WhatsApp, clique em Personalizar.
4. Na seção Configuração da API, selecione uma conta do WhatsApp Business ou crie uma nova:
   • Para usar uma conta existente: selecione a conta do WhatsApp Business no menu suspenso.
   • Para criar uma conta: clique em Criar uma conta do WhatsApp Business e siga as instruções para configurar o seu perfil empresarial.
5. Depois de se conectar, você verá a identificação da conta do WhatsApp Business no painel de configuração da API.
   • Salve essa identificação para usar em chamadas de API.

Observação: se você tiver criado um novo portfólio empresarial da Meta durante a criação do app, uma conta do WhatsApp Business poderá ter sido criada automaticamente para você. Verifique a conexão na seção "Configuração da API" antes de continuar.

1. Clique em Casos de uso (ícone de lápis) na barra lateral.
2. No caso de uso Conectar-se com clientes pelo WhatsApp, clique em Personalizar.
3. Em Início rápido, clique no botão Começar a usar a API e siga as duas primeiras etapas para enviar o modelo de mensagem hello_world a um número de telefone da sua escolha.
   • Guarde a identificação do número de telefone de teste e a identificação da conta do WhatsApp Business para usar mais tarde.
4. Depois de receber a mensagem que você enviou, responda para manter a conversa ativa.

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "215589313241560883",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "15551797781",
              "phone_number_id": "7794189252778687"
            },
            "contacts": [
              {
                "profile": {
                  "name": "Jessica Laverdetman"
                },
                "wa_id": "13557825698"
              }
            ],
            "messages": [
              {
                "from": "17863559966",
                "id": "wamid.HBgLMTc4NjM1NTk5NjYVAGHAYWYET688aASGNTI1QzZFQjhEMDk2QQA=",
                "timestamp": "1758254144",
                "text": {
                  "body": "Hi!"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

1. Acesse Configurações do negócio⁠ e clique em Usuários do sistema na barra lateral.
2. Clique no botão Adicionar+ no canto superior direito e siga as instruções para criar um novo usuário do sistema.
3. Selecione o novo usuário do sistema que você criou e clique em Atribuir ativos.
   • Selecione o app e ative Gerenciar app em Controle total.
   • Selecione sua conta do WhatsApp e ative a opção Gerenciar contas do WhatsApp Business em Controle total.
   • Clique no botão Atribuir ativos.
4. Clique em Gerar token.
   • Siga as instruções para gerar o token.
   • Adicione as seguintes permissões ao token:
     • business_management
     • whatsapp_business_messaging
     • whatsapp_business_management
   • Copie o token e guarde-o em um local seguro para usá-lo nas etapas seguintes.

curl 'https://graph.facebook.com/v23.0/<TEST_BUSINESS_PHONE_NUMBER_ID>/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <SYSTEM_USER_ACCESS_TOKEN>' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "text",
  "text": {
    "body": "Hello!"
  }
}'

• Conheça os diferentes tipos de mensagens que não são de modelo
• Saiba como criar e enviar mensagens de modelo
• Saiba como criar e gerenciar grupos do WhatsApp via API
• Saiba como enviar e receber ligações no WhatsApp via API
• Saiba como adicionar um número de telefone comercial
• Aprenda a configurar seu próprio servidor de webhook
• Torne-se um provedor de soluções
• Veja a especificação OpenAPI da API do WhatsApp⁠