Configurando o WhatsApp

Introdução

A integração do WhatsApp permite que seus agentes respondam às mensagens do WhatsApp diretamente do 3CX. As mensagens do WhatsApp são entregues no mesmo painel de chat que o chat ao vivo, SMS e mensagens do Facebook, permitindo que você responda a vários canais facilmente e com a mesma equipe.

Requisitos

  • É necessário ter uma conta na Plataforma do WhatsApp Business configurada. Você pode realizar o processo de verificação Empresarial neste momento, mas o serviço não funcionará plenamente até que a verificação seja concluída.
  • É necessário adicionar um número de telefone que você controle. Esse número não deve estar cadastrado em nenhuma outra conta do WhatsApp, seja virtualmente ou em um dispositivo. Se você quiser usar um número que já esteja configurado no WhatsApp, será necessário excluir primeiro a conta do WhatsApp associada a ele. Saiba mais aqui.
  • A integração com o WhatsApp destina-se apenas a responder a mensagens recebidas. Você não pode iniciar uma conversa com um usuário do WhatsApp; o usuário do WhatsApp deve enviar uma mensagem para você primeiro. Você terá então 24 horas para responder à mensagem.
  • Sempre use a versão mais recente da API do WhatsApp.

Passo 1: Criar um Aplicativo do WhatsApp

Escolha do caso de uso WhatsApp

  • Acesse https://developers.facebook.com e clique em “Entrar”, no canto superior direito.
  • Acesse “Meus aplicativos”, clique em “Criar aplicativo”, digite um nome e clique em “Avançar”.
  • Selecione “Conectar-se com os clientes pelo WhatsApp” e clique em “Avançar”.
  • Escolha o Portfólio de Negócios correto e clique em “Avançar”.

Configurações Básicas do aplicativo Meta com App ID, chave secreta e URLs regulatórios

  • Para uma nova empresa, certifique-se de adicionar o máximo de informações possível, especialmente os URLs regulatórios, em Configurações do Aplicativo > Básico.

Configurações Básicas do aplicativo Meta: App ID, App secret, URLs regulatórios e categoria

  • Caso haja algum requisito adicional listado, você deve atendê-lo antes de prosseguir. Clique em “Avançar”.
  • Confirme as informações na caixa de diálogo “Visão geral” e clique em “Criar aplicativo”.
  • Confirme sua senha do Meta, caso seja solicitado.
  • Você pode alterar o status do Aplicativo para “Publicado” a qualquer momento; caso a Meta tenha quaisquer requisitos adicionais, você será notificado.
  • O status “publicado” é necessário para que os usuários finais possam interagir com sua integração e permite que você coloque o serviço em operação ou o desative. Você pode publicar neste momento, mesmo que o aplicativo ainda não esteja totalmente configurado.

Passo 2: Configurar uma Função de Administrador

Caso você não esteja utilizando uma conta empresarial da Meta já existente, com usuários e funções já definidos, use o menu lateral da seção “Meus aplicativos” e, em “Funções do Aplicativo”, adicione pelo menos um Administrador.

Etapa 3: Configurar o Aplicativo Principal

Acesse Casos de uso e selecione Personalizar.

Menu Casos de uso com "Conectar-se com clientes pelo WhatsApp" e botão Personalizar

Permissões e Recursos

Certifique-se de que “whatsapp_business_messaging” e “whatsapp_business_management” estejam disponíveis, clicando no botão “+ Adicionar” caso não estejam.

Permissões e Recursos do app WhatsApp

Conectar o WhatsApp ao 3CX

  • Selecione Etapa 1. Experimente no portal do WhatsApp.
  • Anote o seu ID da Conta do WhatsApp Business.
  • Você pode gerar um token de acesso para o número de teste agora ou depois de verificar o número de telefone real.
  • Selecione Etapa 2. Configuração de Produção no portal do WhatsApp.

Webhook do tronco WhatsApp no 3CX

  • No 3CX, acesse Admin > Voz e Chat > Adicionar mensagens > Adicionar WhatsApp.
  • Copie a URL do Webhook do seu PABX; deixe esta página aberta.

Configurar Webhooks do WhatsApp

  • Cole a URL do Webhook no portal do WhatsApp na Etapa 2. Configuração de Produção.
  • Digite uma sequência aleatória em Verificar token; isso não será necessário novamente, portanto não é preciso salvar essa sequência para uso posterior.

Assinatura do webhook "messages" (v25.0) ativada nos campos de webhooks do WhatsApp

  • Certifique-se de que o Webhook “messages” esteja selecionado e que a versão mais recente (neste exemplo, v25.0) esteja selecionada.
  • Clique no botão Verificar e Salvar.
  • Passe para Registrar seu número de telefone do WhatsApp.

Registro do número WhatsApp

  • Insira seu número de telefone e confirme-o.
  • Ative a opção Assinar webhooks.
  • Observação: o ID do número de telefone:
  • Cole o ID do número de telefone e o próprio número de telefone na sua página de configuração do 3CX.
  • Você também pode gerar um token de acesso e colá-lo no 3CX.

Após Concluir a Verificação da Sua Empresa

Verificação da empresa no WhatsApp

Agora você pode testar sua configuração enviando uma mensagem pelo WhatsApp para o seu número comercial do WhatsApp.

Veja Também

Última Atualização

Este documento foi atualizado pela última vez em 8 de setembro de 2026

https://www.3cx.com.br/docs/manual/whatsapp/