Crear llamada de WhatsApp
POST /v2/create-whatsapp-call
Tu agente de voz llama a un contacto por WhatsApp, desde el número de WhatsApp que atiende. Es la misma conversación que una llamada telefónica: mismo agente, instrucciones, funciones, transcripción y grabación.
Hace falta:
- Un agente de voz VPower que atienda un número de WhatsApp de tu cuenta (en la ficha del agente: Número de teléfono → Números de WhatsApp → Atender llamadas de WhatsApp). Ver Llamadas de WhatsApp.
- Que el contacto haya dado permiso para que lo llamen por WhatsApp. Se consulta y se pide con Permiso para llamar por WhatsApp.
Parámetros del cuerpo
Requeridos
| Campo | Tipo | Descripción |
|---|---|---|
agent_id |
string | El agente de voz que llama. |
to_number |
string | Número de WhatsApp del contacto en formato E.164. Ejemplo: +5491122334455 |
Opcionales
| Campo | Tipo | Descripción |
|---|---|---|
fallback_to_phone |
boolean | true: si el contacto no dio permiso, lo llama por teléfono con el número del agente. Por defecto false: si no se puede por WhatsApp, responde un error y no llama. |
whatsapp_number |
string | Si el agente atiende varios números de WhatsApp, desde cuál llamar (E.164). |
from_number |
string | Solo con fallback_to_phone: número de teléfono de origen si la llamada sale por teléfono. Si no lo indicas, se usa el del agente. |
metadata |
object | Objeto libre para guardar información adicional. Se recupera desde el objeto de llamada. |
dynamic_variables |
object | Pares clave-valor que se inyectan en el prompt del agente. Ejemplo: {"nombre_cliente": "Juan"} |
Respuesta — 201 Created
Devuelve el objeto de la llamada, igual que Crear llamada telefónica, con el campo channel: whatsapp si salió por WhatsApp o phone si salió por teléfono (con fallback_to_phone).
channel también aparece al obtener o listar llamadas.
Si la persona no atiende, la llamada termina con disconnection_reason = dial_no_answer.
Ejemplo de solicitud
curl --request POST \
--url https://calls.anunzi.net/v2/create-whatsapp-call \
--header 'Authorization: Bearer TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"agent_id": "agent_7f3c9d2e1b",
"to_number": "+5491122334455",
"dynamic_variables": { "nombre_cliente": "María López" },
"metadata": { "crm_id": "LEAD-9821" }
}'
Por WhatsApp si dio permiso, si no por teléfono:
curl --request POST \
--url https://calls.anunzi.net/v2/create-whatsapp-call \
--header 'Authorization: Bearer TU_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"agent_id": "agent_7f3c9d2e1b",
"to_number": "+5491122334455",
"fallback_to_phone": true
}'
Ejemplo de respuesta
{
"call_id": "lk_54929450cde28c099cf3",
"call_type": "phone_call",
"agent_id": "agent_7f3c9d2e1b",
"agent_version": 10,
"call_status": "registered",
"direction": "outbound",
"from_number": "+5491155550190",
"to_number": "+5491122334455",
"channel": "whatsapp",
"metadata": { "crm_id": "LEAD-9821" }
}
Errores propios de WhatsApp
| Código | code |
Qué pasó |
|---|---|---|
409 |
no_call_permission |
El contacto todavía no dio permiso. Pídeselo con Permiso para llamar por WhatsApp. |
409 |
no_whatsapp_line |
El agente no atiende ningún número de WhatsApp con las llamadas activas. |
409 |
number_cannot_call |
El número de WhatsApp es de EE. UU., Canadá, Egipto, Vietnam o Nigeria: puede recibir llamadas, pero no hacerlas. |
409 |
agent_not_migrated |
El agente todavía está en el motor de voz anterior: las llamadas de WhatsApp funcionan con VPower. |
429 |
whatsapp_call_limit |
WhatsApp no permite llamar a ese contacto ahora (límite de llamadas). |
Los demás códigos son los de la API de llamadas de voz.
Cuánto cuesta
16 créditos por minuto, desde que la persona atiende. Si no atiende, se cobra solo el intento (2 créditos).