Pular para o conteúdo principal

​
Endpoint

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

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/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

CampoTipoObrigatórioDescrição
phonestringSimNúmero de telefone no formato E.164 (ex.: +5511999999999)
messagestringNãoMensagem pré-preenchida (codificada automaticamente na URL)

​
Exemplo

{
  "phone": "+5511999999999",
  "message": "Olá, tenho uma dúvida!"
}

​
Resposta

​
200 OK

CampoTipoDescrição
urlstringLink de clique para o WhatsApp gerado
phonestringNúmero de telefone normalizado utilizado
Exemplo 
{
  "url": "https://wa.me/5511999999999?text=Ol%C3%A1%2C%20tenho%20uma%20d%C3%BAvida%21",
  "phone": "+5511999999999"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

Número de telefone inválido. 
{
  "detail": "Invalid phone number format"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

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!"}'