Documentación
API de Anunzi.md

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).

Esc