Skip to main content

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

1

Acesse Configurações

No dashboard, vá em Configurações → API Tokens.
2

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.
3

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