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

# Início rápido

> Faça uma consulta de leitura e depois envie uma mensagem de teste deliberadamente.

## Antes de começar

Você precisa de uma chave de API do Watahub e um telefone ativo atribuído à conta. A URL base é `https://cloud.watahub.dev`. Os exemplos contêm marcadores; nenhuma requisição foi executada para você.

## Consulte seus números

```bash theme={null}
curl --fail-with-body 'https://cloud.watahub.dev/v1/phones' \
  -H "Authorization: Bearer $WATAHUB_API_KEY"
```

Use o ID do telefone escolhido na resposta, não o número de exibição.

## Envie uma mensagem de teste

> [!WARNING]
>
> Isto envia uma mensagem real do WhatsApp. Contate somente um destinatário autorizado. As regras de mensagens da Meta continuam válidas.

```bash theme={null}
curl --fail-with-body 'https://cloud.watahub.dev/v1/messages' \
  -H "Authorization: Bearer $WATAHUB_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"phoneNumberId":"PHONE_NUMBER_ID","to":"RECIPIENT_NUMBER","kind":"text","text":{"body":"Olá do Watahub"}}'
```

Substitua os dois marcadores. Uma resposta de sucesso inclui `success`, `messageId`, `recipient` e `phoneNumberId`. A aceitação não comprova a entrega: use [webhooks de status](https://docs.watahub.dev/pt-BR/webhooks.md).

Em `unknown_outcome`, não repita às cegas: a mensagem pode ter sido enviada. Consulte [erros e novas tentativas](https://docs.watahub.dev/pt-BR/errors.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.