Columba · Docs

Tema

Conectar WhatsApp via API Oficial (Meta) ​

A opção API Oficial (Meta) conecta o Columba ao seu número de WhatsApp usando a Cloud API da própria Meta, com credenciais que você mesmo cria e cola no painel. É uma alternativa ao QR Code para quem já opera (ou quer operar) na infraestrutura oficial da Meta.

INFO

Esta opção usa suas próprias credenciais de desenvolvedor Meta. O Columba não cria nem gerencia o app Meta por você — a configuração inicial na plataforma da Meta é de sua responsabilidade.

Pré-requisitos ​

Antes de começar, você precisa ter, na plataforma da Meta:

  • Uma conta Meta Business.
  • Um app criado no painel de desenvolvedores da Meta, com o produto WhatsApp configurado.
  • Um número de telefone cadastrado na Cloud API desse app.

Criar a instância no Columba ​

  1. Acesse Configurações → Conectores.
  2. Na seção WhatsApp, clique em Nova instância.
  3. Preencha o Nome da instância.
  4. Em Tipo de conexão, selecione API Oficial (Meta).
  5. Preencha os cinco campos de credenciais (veja abaixo onde encontrar cada um).
  6. Clique em Criar instância.

Onde encontrar cada credencial no painel da Meta ​

Campo no ColumbaOnde encontrar na Meta
Phone Number IDNo app Meta, em WhatsApp → API Setup (ou Configuration), na seção do número de telefone cadastrado.
WhatsApp Business Account ID (WABA)Na mesma tela de configuração do WhatsApp, junto aos dados da sua conta comercial (WhatsApp Business Account).
Access Token (permanente / System User)Gerado no Meta Business Suite, através de um usuário do sistema (System User) com permissão para a Cloud API. Use um token permanente — tokens temporários de teste expiram e interrompem a conexão.
App SecretNas configurações do app, em Configurações básicas do app (App Settings → Basic).
Verify TokenUm texto que você mesmo define. Não vem da Meta — você escolhe uma palavra ou frase e usa o mesmo valor ao configurar o webhook (próximo passo).

Cuidado

O Access Token e o App Secret dão acesso ao envio de mensagens em nome do seu número. Trate-os como senhas: não compartilhe fora do painel do Columba.

Configurar o webhook na Meta ​

Depois de criar a instância com sucesso, o Columba mostra a janela Configure o webhook na Meta, com a Callback URL desta instância pronta para copiar.

  1. Copie a Callback URL exibida na janela (ou, depois, pelo botão Configurações no card da instância).
  2. No painel do seu app Meta, acesse WhatsApp → Configuration → Webhooks.
  3. Cole a Callback URL no campo de URL de retorno de chamada (callback).
  4. Informe o mesmo Verify Token que você definiu na criação da instância.
  5. Assine (subscribe) o campo messages.

Sem esse passo, o número fica cadastrado no Columba, mas as mensagens recebidas não chegam ao seu Chat.

Leia também ​