> ## 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.

# Mensagem de imagem

> Envie uma imagem JPG, JPEG ou PNG com legenda opcional.

Envie uma imagem JPG, JPEG ou PNG com legenda opcional.

## 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                        |

**Limite:** 20 solicitações por minuto para cada combinação de chave de API e `fromPhoneNumber`.

## Exemplo de payload

```json theme={null}
{
  "fromPhoneNumber": "14844634680",
  "toPhoneNumber": "919675360316",
  "type": "image",
  "url": "https://cdn.example.com/offer.jpg",
  "caption": "This week only"
}
```

## 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      |