API de Anunzi.md
Permiso para llamar por WhatsApp
WhatsApp solo deja llamar a quien dio permiso. El permiso puede ser temporal (7 días) o permanente, y la persona lo puede quitar cuando quiera. Con estas dos rutas tu sistema consulta si el contacto dio permiso y se lo pide.
En las dos, agent_id es el agente de voz que atiende el número de WhatsApp. Si atiende varios números, indica cuál con whatsapp_number.
Consultar el permiso
GET /v2/get-whatsapp-call-permission?agent_id=…&phone=…
| Parámetro | Tipo | Descripción |
|---|---|---|
agent_id |
string | El agente de voz. |
phone |
string | Teléfono del contacto, con código de país. Ejemplo: +5491122334455 |
whatsapp_number |
string | Opcional: el número de WhatsApp, si el agente atiende varios. |
curl --request GET \
--url 'https://calls.anunzi.net/v2/get-whatsapp-call-permission?agent_id=agent_7f3c9d2e1b&phone=%2B5491122334455' \
--header 'Authorization: Bearer TU_API_KEY'
Respuesta — 200 OK
{
"phone": "+5491122334455",
"whatsapp_number": "+5491155550190",
"status": "temporary",
"granted": true,
"expires_at": "2026-11-23T14:00:00Z",
"can_request": false,
"can_call": true,
"requested_at": "2026-11-16T13:58:00Z"
}
| Campo | Descripción |
|---|---|
status |
temporary, permanent o no_permission. |
granted |
true si se lo puede llamar por WhatsApp. |
expires_at |
Vencimiento del permiso temporal (null si es permanente o no hay permiso). |
can_request |
Si ahora WhatsApp permite pedirle permiso. |
can_call |
Si ahora WhatsApp permite llamarlo. |
requested_at |
Cuándo se le pidió permiso por última vez. |
Pedir permiso
POST /v2/request-whatsapp-call-permission
| Campo | Tipo | Descripción |
|---|---|---|
agent_id |
string | El agente de voz. Requerido. |
phone |
string | Teléfono del contacto, con código de país. Requerido. |
text |
string | Opcional: el texto del mensaje que acompaña el botón (solo si la conversación está abierta). |
whatsapp_number |
string | Opcional: el número de WhatsApp, si el agente atiende varios. |
curl --request POST \
--url https://calls.anunzi.net/v2/request-whatsapp-call-permission \
--header 'Authorization: Bearer TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"agent_id": "agent_7f3c9d2e1b",
"phone": "+5491122334455",
"text": "¿Te podemos llamar por WhatsApp para coordinar la visita?"
}'
- Si la conversación con el contacto está abierta (escribió en las últimas 24 h), le llega un mensaje con un botón para dar permiso, con tu
text. Es gratis. - Si no, le llega la plantilla de permiso de tu número, que se cobra como cualquier plantilla de WhatsApp.
- La respuesta trae los mismos campos que la consulta, más
requested: trueyvia(interactiveotemplate). Si ya había dado permiso, responderequested: falsey no envía nada. - WhatsApp permite 1 pedido por día y 2 por semana por contacto.
Cuando el contacto acepta, el permiso queda guardado: puedes consultarlo de nuevo o llamarlo con Crear llamada de WhatsApp.
Errores
| Código | code |
Qué pasó |
|---|---|---|
400 |
missing_phone |
Falta el teléfono del contacto. |
409 |
no_whatsapp_line |
El agente no atiende ningún número de WhatsApp con las llamadas activas. |
429 |
permission_request_limit |
WhatsApp no permite pedirle permiso ahora (1 por día y 2 por semana). |
502 |
whatsapp_error |
WhatsApp no respondió o rechazó el pedido (la respuesta trae el detalle). |