Guia Rápido

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 e o número do destinatário pelos seus valores:

curl -X POST https://apis.vectalk.com.br/api/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 🚀"
    }
  }'

const response = await fetch(
  'https://apis.vectalk.com.br/api/messages',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      messaging_product: 'whatsapp',
      to: '5511999999999',
      type: 'text',
      text: { body: 'Olá! Esta é minha primeira mensagem via Vectax Hub 🚀' },
    }),
  }
);

const data = await response.json();
console.log(data.messages[0].id); // wamid...

import requests

response = requests.post(
    'https://apis.vectalk.com.br/api/messages',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
    json={
        'messaging_product': 'whatsapp',
        'to': '5511999999999',
        'type': 'text',
        'text': {'body': 'Olá! Esta é minha primeira mensagem via Vectax Hub 🚀'},
    }
)

print(response.json()['messages'][0]['id'])  # wamid...

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/api/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

Primeiros Passos

Conceitos

1. Crie sua conta

2. Conecte seu WhatsApp Business

3. Gere um API Token

4. Envie sua primeira mensagem

5. Receba mensagens (Webhook)

Próximos passos

Tipos de mensagem

Upload de mídia

Templates

​1. Crie sua conta

​2. Conecte seu WhatsApp Business

​3. Gere um API Token

​4. Envie sua primeira mensagem

​5. Receba mensagens (Webhook)

​Próximos passos

Tipos de mensagem

Upload de mídia

Templates

1. Crie sua conta

2. Conecte seu WhatsApp Business

3. Gere um API Token

4. Envie sua primeira mensagem

5. Receba mensagens (Webhook)

Próximos passos