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

# Comece em 5 minutos

> Da criação da chave ao primeiro envio de mensagem WhatsApp.

<Steps>
  <Step title="Crie sua chave de API">
    No painel da Superlead, acesse **Integrações** e gere uma nova chave de API.

    <Warning>
      A chave completa (`sl_live_...`) é exibida **uma única vez**, no momento da criação. Copie e guarde em um cofre de segredos. Se perder, revogue e crie outra.
    </Warning>
  </Step>

  <Step title="Envie sua primeira mensagem">
    O destinatário em `to` precisa ser um lead existente da sua empresa (telefone em formato E.164). Para conversas abertas nas últimas 24 horas, envie texto livre:

    ```bash theme={null}
    curl -X POST https://api.superlead.app/v1/messages \
      -H "Authorization: Bearer sl_live_SUA_CHAVE" \
      -H "Content-Type: application/json" \
      -d '{
        "to": "+5511999999999",
        "type": "text",
        "text": { "body": "Olá! Tudo certo com seu agendamento?" }
      }'
    ```

    Se o lead não falou com você nas últimas 24 horas, use um template aprovado:

    ```bash theme={null}
    curl -X POST https://api.superlead.app/v1/messages \
      -H "Authorization: Bearer sl_live_SUA_CHAVE" \
      -H "Content-Type: application/json" \
      -d '{
        "to": "+5511999999999",
        "type": "template",
        "template": { "name": "nome_do_template", "language": { "code": "pt_BR" } }
      }'
    ```

    A resposta `201` confirma que a mensagem foi aceita:

    ```json theme={null}
    {
      "id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "wamid": "wamid.HBgMNTU...",
      "external_id": null,
      "to": "+5511999999999",
      "type": "text",
      "status": "accepted",
      "created_at": "2026-07-03T14:30:00.000Z"
    }
    ```
  </Step>

  <Step title="Consulte o status de entrega">
    `accepted` significa que o WhatsApp aceitou a mensagem — não que ela foi entregue. Use o `id` retornado para acompanhar:

    ```bash theme={null}
    curl https://api.superlead.app/v1/messages/msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f \
      -H "Authorization: Bearer sl_live_SUA_CHAVE"
    ```

    ```json theme={null}
    {
      "id": "msg_9f8e7d6c-1a2b-3c4d-5e6f-7a8b9c0d1e2f",
      "status": "delivered",
      "status_updated_at": "2026-07-03T14:30:04.000Z",
      "error": null
    }
    ```

    <Check>
      Pronto. Você criou uma chave, enviou uma mensagem e consultou o status real de entrega.
    </Check>
  </Step>
</Steps>

## Próximos passos

<Columns cols={2}>
  <Card title="Envio de mensagens" icon="send" href="/guias/envio-de-mensagens">
    Tipos de mensagem, janela de 24 horas e falhas assíncronas.
  </Card>

  <Card title="Tratamento de erros" icon="triangle-alert" href="/guias/erros">
    O envelope de erro e o catálogo completo de códigos.
  </Card>
</Columns>