Skip to main content
GET
/
user
/
whatsapp
/
senders
curl -X GET "https://suasofia.online/api/user/whatsapp/senders" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": 12,
      "phone_number": "+14155551234",
      "display_name": "Acme Corp Support",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": 10000,
      "messaging_limit_formatted": "10,000 / 24hr"
    },
    {
      "id": 15,
      "phone_number": "+442071234567",
      "display_name": "Acme Corp Sales",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": null,
      "messaging_limit_formatted": "Unlimited"
    }
  ]
}
Este endpoint retorna uma lista de remetentes WhatsApp Business (números de telefone) configurados para sua conta. Use isso para obter IDs de remetentes necessários para enviar mensagens.

​
Parâmetros de Consulta

​
status
string
Filtrar remetentes por status. Padrão: online. Use all para retornar todos os remetentes independentemente do status.

​
Campos de Resposta

​
data
array
curl -X GET "https://suasofia.online/api/user/whatsapp/senders" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": 12,
      "phone_number": "+14155551234",
      "display_name": "Acme Corp Support",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": 10000,
      "messaging_limit_formatted": "10,000 / 24hr"
    },
    {
      "id": 15,
      "phone_number": "+442071234567",
      "display_name": "Acme Corp Sales",
      "status": "online",
      "quality_rating": "GREEN",
      "messaging_limit": null,
      "messaging_limit_formatted": "Unlimited"
    }
  ]
}

​
Notas

  • Apenas remetentes com status online são retornados por padrão. Use ?status=all para incluir remetentes offline.
  • O status do remetente é sincronizado com a Meta a cada 5 minutos automaticamente.
  • O campo id é o que você precisa passar como sender_id ao enviar mensagens.
  • A classificação de qualidade afeta seus limites de mensagens. Uma classificação RED pode restringir sua capacidade de enviar mensagens.