> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectalk.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia Rápido

> Envie sua primeira mensagem WhatsApp em menos de 5 minutos

## 1. Crie sua conta

Acesse o [dashboard](https://apps.vectalk.com.br) 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

<Steps>
  <Step title="Acesse Configurações">
    No dashboard, vá em **Configurações → API Tokens**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Copie o token">
    O token é exibido **apenas uma vez**. Guarde em local seguro.
  </Step>
</Steps>

<Warning>
  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.
</Warning>

## 4. Envie sua primeira mensagem

Substitua `YOUR_TOKEN` e o número do destinatário pelos seus valores:

<CodeGroup>
  ```bash cURL theme={null}
  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 🚀"
      }
    }'
  ```

  ```javascript Node.js theme={null}
  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...
  ```

  ```python Python theme={null}
  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...
  ```
</CodeGroup>

**Resposta esperada:**

```json theme={null}
{
  "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:

```bash theme={null}
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](/concepts/webhooks).

## Próximos passos

<CardGroup cols={3}>
  <Card title="Tipos de mensagem" icon="message" href="/api-reference/messages/send">
    Imagem, documento, template, botões interativos e mais
  </Card>

  <Card title="Upload de mídia" icon="paperclip" href="/api-reference/media/upload">
    Envie arquivos e use o media\_id nas mensagens
  </Card>

  <Card title="Templates" icon="file-lines" href="/api-reference/templates/create">
    Crie e gerencie templates aprovados pela Meta
  </Card>
</CardGroup>