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

# POST /wpp-url/generate

> Gere links de clique para o WhatsApp para qualquer número, com normalização automática para E.164 e codificação de mensagem pré-preenchida na URL.

## Endpoint

```
POST https://api.bunny.build/api/v1/wpp-url/generate
```

## Autenticação

| Header         | Obrigatório | Valor                        |
| -------------- | ----------- | ---------------------------- |
| `X-API-Key`    | Sim         | Sua chave de API (`bun_...`) |
| `Content-Type` | Sim         | `application/json`           |

## Visão geral

Gere links de clique para o WhatsApp para qualquer número de telefone. A Bunny normaliza o número para o formato internacional E.164 e retorna um link direto `wa.me`. Se uma mensagem for fornecida, também retorna uma versão com a mensagem pré-preenchida e codificada na URL.

## Casos de uso

* Adicionar botões "Fale pelo WhatsApp" em landing pages e páginas de produtos
* Gerar links de suporte pelo WhatsApp a partir do seu CRM
* Criar links de campanhas de marketing com mensagens pré-preenchidas
* Automatizar fluxos de onboarding que abrem conversas no WhatsApp

## Detalhes

Os números podem ser passados com ou sem código de país, espaços, hífens ou parênteses. Todos os formatos são normalizados automaticamente. Números brasileiros (10 ou 11 dígitos sem código de país) recebem o prefixo `+55` automaticamente.

## Corpo da requisição

| Campo     | Tipo   | Obrigatório | Descrição                                                   |
| --------- | ------ | ----------- | ----------------------------------------------------------- |
| `phone`   | string | Sim         | Número de telefone no formato E.164 (ex.: `+5511999999999`) |
| `message` | string | Não         | Mensagem pré-preenchida (codificada automaticamente na URL) |

### Exemplo

```json theme={null}
{
  "phone": "+5511999999999",
  "message": "Olá, tenho uma dúvida!"
}
```

## Resposta

### 200 OK

| Campo   | Tipo   | Descrição                                |
| ------- | ------ | ---------------------------------------- |
| `url`   | string | Link de clique para o WhatsApp gerado    |
| `phone` | string | Número de telefone normalizado utilizado |

**Exemplo**

```json theme={null}
{
  "url": "https://wa.me/5511999999999?text=Ol%C3%A1%2C%20tenho%20uma%20d%C3%BAvida%21",
  "phone": "+5511999999999"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

Número de telefone inválido.

```json theme={null}
{
  "detail": "Invalid phone number format"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

```bash theme={null}
curl -X POST https://api.bunny.build/api/v1/wpp-url/generate \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+5511999999999", "message": "Olá, tenho uma dúvida!"}'
```