Skip to main content
Você vai precisar de quatro valores para usar a API do Coexy. Este guia mostra exatamente onde encontrar cada um no painel.

1. API Key (COEXY_API_KEY)

Usada em todas as chamadas à Management API (/api/*). Caminho: Menu lateral → API Keys → Nova chave
1

Acesse API Keys

No menu lateral do painel, clique em API Keys.
2

Crie uma nova chave

Clique em Nova chave, digite um nome (ex: “Meu CRM”) e clique em Criar chave.
3

Copie imediatamente

A chave completa (crt_pk_...) é exibida apenas uma vez. Copie e salve em local seguro antes de fechar.
Se fechar sem copiar, não há como recuperar. Delete e crie uma nova.

2. Channel Token (channel_token)

Usado nas chamadas ao meta-proxy (/meta-proxy/*) para enviar mensagens. Caminho: Menu lateral → Canais → clique no canal → aba API
1

Acesse Canais

No menu lateral, clique em Canais.
2

Abra o detalhe do canal

No card do canal desejado, clique em Configurar.
3

Vá para a aba API

Clique na aba API. O card “Seu Token de Canal” exibe o token completo com botão de copiar.
Na lista de canais, o card mostra só o começo do token (os primeiros 20 caracteres). Para o valor completo, use a aba API do detalhe.

3. WABA ID (waba_id)

ID da sua conta WhatsApp Business na Meta. Necessário para listar e criar templates. Caminho: Menu lateral → Canais → clique no canal → aba API (campo WABA ID) ou aba Configurações
1

Abra o detalhe do canal

Na lista de canais, clique em Configurar no canal desejado.
2

Copie o WABA ID

Na aba API, o campo WABA ID tem botão de copiar. Ele também aparece na aba Configurações, seção Conexão WhatsApp.
O WABA ID só aparece após o número ser conectado. Antes disso, a aba API mostra “Conecte o WhatsApp para obter”.

4. Phone Number ID (phone_number_id)

ID do número de telefone na Meta. Usado como {entity_id} nas chamadas de envio de mensagem. Caminho: Menu lateral → Canais → clique no canal → aba API
1

Abra o detalhe do canal

Na lista de canais, clique em Configurar.
2

Vá para a aba API

Clique na aba API. O campo Phone Number ID tem botão de copiar, e os exemplos de curl já vêm com o valor real do canal.
Assim como o WABA ID, o phone_number_id só é preenchido após conectar o número. Antes disso, os exemplos mostram o placeholder {PHONE_NUMBER_ID_DO_CANAL}.

5. Como conectar um número WhatsApp

Antes de ter o waba_id e o phone_number_id, você precisa conectar um número ao canal.
1

Crie um canal

Em Canais, clique em Novo Canal, dê um nome e confirme.
2

Obtenha o link de conexão

No card do canal recém-criado, clique no botão de compartilhar (ícone ao lado de Configurar) para copiar o link de conexão, ou abra o canal em Configurar e clique em Conectar no topo da página.
3

Acesse o link

Abra o link copiado. A página mostra a logo, o nome e a cor da sua organização (configure em Configurações › Organização › Marca na página de conexão) e o botão Conectar WhatsApp Business. Aberta no celular, a página sugere enviar o link para o computador, onde a janela da Meta funciona melhor; dá para ignorar e seguir pelo celular.
4

Autorize via Meta

Clique no botão. Uma janela da Meta abrirá — siga o fluxo de WhatsApp Embedded Signup para autorizar o número. Enquanto a janela está aberta, a página mostra Continue na janela da Meta; vá até a última etapa e clique em Concluir.
5

Conexão concluída

Após autorizar, a página de conexão exibe “Tudo certo! Seu WhatsApp está conectado” (ou leva para a sua URL de redirecionamento após a conexão, se configurada). O canal agora terá waba_id, phone_number_id e display_phone_number preenchidos. Se a janela for fechada antes do fim ou a Meta recusar, a página mostra Não conseguimos concluir a conexão com o botão Tentar novamente.
Tokens são gerenciados automaticamente pelo Coexy. Após conectar o WhatsApp, você não precisa se preocupar com renovação de tokens — o Coexy cuida disso. Em casos raros (ex: revogação de permissão na Meta), o canal muda para disconnected e você deve reconectar pelo mesmo connect_url.

Resumo