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

# Visão geral

> Envie uma mensagem de texto, mídia, localização ou interativa usando um número da organização.

## Enviar mensagem de formato livre

Envia uma única mensagem para um destinatário. Todos os oito tipos de conteúdo compartilham este endpoint — o campo `type` decide quais outros campos são obrigatórios.

### Endpoint

```http theme={null}
POST /broadcast/public/send-freeform
```

### Campos comuns

| Campo             | Tipo  | Obrigatório | Descrição                                       |
| ----------------- | ----- | ----------- | ----------------------------------------------- |
| `fromPhoneNumber` | corda | Obrigatório | Seu número WABA                                 |
| `toPhoneNumber`   | corda | Obrigatório | Destinatário com código do país, apenas dígitos |
| `type`            | corda | Obrigatório | Um dos oito tipos abaixo                        |

### Campos específicos do tipo

| `type`        | Obrigatório             | Opcional          | Extensões de arquivo aceitas              |
| ------------- | ----------------------- | ----------------- | ----------------------------------------- |
| `text`        | `text`                  | —                 | —                                         |
| `image`       | `url`                   | `caption`         | jpg, jpeg, png                            |
| `document`    | `url`                   | `name`, `caption` | pdf, txt, doc, docx, ppt, pptx, xls, xlsx |
| `audio`       | `url`                   | —                 | aac, amr, mp3, m4a, mp4, ogg, opus        |
| `video`       | `url`                   | `caption`         | mp4, 3gp                                  |
| `sticker`     | `url`                   | —                 | webp                                      |
| `location`    | `latitude`, `longitude` | `name`, `address` | —                                         |
| `interactive` | `interactive`           | —                 | —                                         |

<Warning>
  **A extensão é lida a partir do caminho do URL, não do arquivo.** Um PNG real servido a partir de um URL que termina em `.webp` é rejeitado para `image`, e um URL sem extensão é rejeitado para cada tipo de mídia. As strings de consulta são ignoradas, então `…/photo.png?v=2` está bem.
</Warning>

## Tipos de mensagem

<CardGroup cols={2}>
  <Card title="Mensagem de texto" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/text-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de imagem" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/image-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de documento" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/document-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de áudio" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/audio-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de vídeo" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/video-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de adesivo" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/sticker-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem de localização" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/location-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
  <Card title="Mensagem interativa" href="/pt/api-reference/endpoints/broadcast-api/send-free-form-message/interactive-message">Consulte os campos e o exemplo deste tipo de mensagem.</Card>
</CardGroup>

## Resposta bem-sucedida

O endpoint retorna o mesmo formato de sucesso para este tipo de conteúdo.

```json theme={null}
{
  "status": true,
  "status_code": 200,
  "message": "Free-form message queued successfully",
  "data": {}
}
```

## Erros

| Status         | Causa                                            | O que verificar                             |
| -------------- | ------------------------------------------------ | ------------------------------------------- |
| `400`          | Um campo comum ou específico é inválido          | Confira os campos obrigatórios desta página |
| `400`          | A URL ou extensão da mídia não é compatível      | Use `http` ou `https` e uma extensão aceita |
| `400`          | Coordenadas, botões ou linhas excedem os limites | Corrija os limites do payload               |
| `401`          | A chave ou remetente não pertence à organização  | Use um remetente retornado pela mesma chave |
| `429`          | O limite de 20 solicitações foi excedido         | Aguarde o intervalo informado na resposta   |
| `500` ou `503` | Falha transitória do serviço                     | Tente novamente com espera exponencial      |