1. Crie sua conta
Acesse o dashboard e registre-se. Ao criar sua conta, uma organização é gerada automaticamente.
2. Conecte seu WhatsApp Business
Na aba Instâncias, clique em Conectar conta e siga o fluxo de integração com a Meta (Embedded Signup). Você precisará de:
- Uma conta Meta Business verificada
- Um número de telefone registrado no WhatsApp Business
Ao final, o Hub importa automaticamente o phone_number_id, waba_id e o token de acesso.
3. Gere um API Token
Acesse Configurações
No dashboard, vá em Configurações → API Tokens.
Crie um token
Clique em Novo Token. Você pode criar um token para toda a organização ou vinculado a uma instância específica.
Copie o token
O token é exibido apenas uma vez. Guarde em local seguro.
Tokens instance-bound só funcionam com a instância para a qual foram criados. Use tokens de organização se precisar acessar múltiplas instâncias.
4. Envie sua primeira mensagem
Substitua YOUR_TOKEN, PHONE_NUMBER_ID e RECIPIENT pelos seus valores:
curl -X POST https://apis.vectalk.com.br/whatsapp/PHONE_NUMBER_ID/messages \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999999999",
"type": "text",
"text": {
"body": "Olá! Esta é minha primeira mensagem via Vectax Hub 🚀"
}
}'
Resposta esperada:
{
"messaging_product": "whatsapp",
"contacts": [
{ "input": "5511999999999", "wa_id": "5511999999999" }
],
"messages": [
{ "id": "wamid.HBgLNTUxMTk5OTk5OTk5..." }
]
}
5. Receba mensagens (Webhook)
Para receber mensagens e status de entrega em tempo real, registre uma URL de webhook:
curl -X POST https://apis.vectalk.com.br/webhooks \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"instance_id": "YOUR_INSTANCE_ID",
"url": "https://meuapp.com/webhook",
"name": "Meu Webhook"
}'
O Hub vai encaminhar todos os eventos da Meta para a URL registrada. Veja o formato completo em Webhooks.
Próximos passos
Tipos de mensagem
Imagem, documento, template, botões interativos e mais
Upload de mídia
Envie arquivos e use o media_id nas mensagens
Templates
Crie e gerencie templates aprovados pela Meta