curl -X GET "https://suasofia.online/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://suasofia.online/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://suasofia.online/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array de remetentes
import requests
response = requests.get(
'https://suasofia.online/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"data": [
{
"id": 12,
"phone_number": "+14155551234",
"display_name": "Suporte da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": 10000,
"messaging_limit_formatted": "10.000 / 24h"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Vendas da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Ilimitado"
}
]
}
{
"data": []
}
WhatsApp
Obter Remetentes do WhatsApp
Lista todos os remetentes do WhatsApp Business para o usuário autenticado
GET
/
user
/
whatsapp
/
senders
curl -X GET "https://suasofia.online/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://suasofia.online/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://suasofia.online/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array de remetentes
import requests
response = requests.get(
'https://suasofia.online/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"data": [
{
"id": 12,
"phone_number": "+14155551234",
"display_name": "Suporte da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": 10000,
"messaging_limit_formatted": "10.000 / 24h"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Vendas da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Ilimitado"
}
]
}
{
"data": []
}
Este endpoint retorna uma lista de remetentes do WhatsApp Business (números de telefone) configurados para sua conta. Use isso para recuperar os IDs dos remetentes necessários para enviar mensagens.
Parâmetros de Consulta
string
Filtrar remetentes por status. Padrão:
online. Use all para retornar todos os remetentes, independentemente do status.Campos de Resposta
array
Show Propriedades do objeto Remetente
Show Propriedades do objeto Remetente
integer
O identificador único do remetente do WhatsApp. Use este ID ao enviar mensagens.
string
O número de telefone do remetente no formato E.164 (ex:
+14155551234)string
O nome de exibição do WhatsApp Business (nome da empresa mostrado aos destinatários)
string
O status atual do remetente:
online ou offlinestring
A classificação de qualidade da Meta para este remetente:
GREEN, YELLOW ou REDinteger
O limite atual de mensagens (número de destinatários únicos por 24 horas).
null significa ilimitado.string
Limite de mensagens em formato legível (ex:
1.000 / 24h, 10.000 / 24h ou Ilimitado)curl -X GET "https://suasofia.online/api/user/whatsapp/senders" \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X GET "https://suasofia.online/api/user/whatsapp/senders?status=all" \
-H "Authorization: Bearer YOUR_API_KEY"
const response = await fetch(
'https://suasofia.online/api/user/whatsapp/senders',
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
const data = await response.json();
console.log(data.data); // Array de remetentes
import requests
response = requests.get(
'https://suasofia.online/api/user/whatsapp/senders',
headers={'Authorization': 'Bearer YOUR_API_KEY'}
)
senders = response.json()['data']
for sender in senders:
print(f"{sender['display_name']}: {sender['phone_number']}")
{
"data": [
{
"id": 12,
"phone_number": "+14155551234",
"display_name": "Suporte da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": 10000,
"messaging_limit_formatted": "10.000 / 24h"
},
{
"id": 15,
"phone_number": "+442071234567",
"display_name": "Vendas da Acme Corp",
"status": "online",
"quality_rating": "GREEN",
"messaging_limit": null,
"messaging_limit_formatted": "Ilimitado"
}
]
}
{
"data": []
}
Notas
- Apenas remetentes com status
onlinesão retornados por padrão. Use?status=allpara incluir remetentes offline. - O status do remetente é sincronizado com a Meta a cada 5 minutos automaticamente.
- O campo
idé o que você precisa passar comosender_idao enviar mensagens. - A classificação de qualidade afeta seus limites de mensagens. Uma classificação
REDpode restringir sua capacidade de enviar mensagens.

