Mensagem interativa - Eazybe

Envie botões de resposta ou uma lista dentro dos limites permitidos.

Endpoint

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.

Botões de resposta

Até 3 botões de resposta. Mais de três são rejeitados.

{
  "fromPhoneNumber": "14844634680",
  "toPhoneNumber": "919675360316",
  "type": "interactive",
  "interactive": {
    "type": "button",
    "header": { "type": "text", "text": "Renew your plan" },
    "body": { "text": "Your subscription ends in 3 days. Renew now?" },
    "footer": { "text": "Reply STOP to opt out" },
    "action": {
      "buttons": [
        { "type": "reply", "reply": { "id": "renew_yes", "title": "Renew now" } },
        { "type": "reply", "reply": { "id": "renew_later", "title": "Remind me later" } }
      ]
    }
  }
}

Interativo — lista

Até 10 linhas contadas em todas as seções combinadas, não por seção.

{
  "fromPhoneNumber": "14844634680",
  "toPhoneNumber": "919675360316",
  "type": "interactive",
  "interactive": {
    "type": "list",
    "header": { "type": "text", "text": "Pick a plan" },
    "body": { "text": "Choose the plan that fits your team." },
    "action": {
      "button": "View plans",
      "sections": [
        {
          "title": "Monthly",
          "rows": [
            { "id": "starter_m", "title": "Starter", "description": "3 seats included" },
            { "id": "growth_m", "title": "Growth", "description": "10 seats included" }
          ]
        }
      ]
    }
  }
}

Resposta bem-sucedida

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

{
  "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