TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no
El módulo /api/call/* cubre el inicio de llamadas de voz y la creación de enlaces de llamada compartibles desde la instancia. Actualmente hay cinco operaciones: la llamada fake, que hace sonar el teléfono unos segundos y cuelga sola (sin audio); la llamada con audio, que llama y reproduce un archivo cuando el destinatario atiende; la creación de enlace de llamada, que genera un enlace compartible (audio o video) que cualquiera puede abrir para unirse; la previsualización de enlace de llamada, que consulta los metadatos de un enlace sin unirse a la llamada; y la programación de llamada, que crea un enlace y envía una tarjeta de evento con ese enlace, título y hora de inicio. Todas las rutas validan la propiedad de la instancia y aceptan TokenAccount o TokenInstance.
Endpoints disponibles
Estructura común
Destinatario (number)
Ambos endpoints reciben el destino en el campo number, que acepta:
- Número simple:
"5511999999999"(preferido). - JID privado:
"5511999999999@s.whatsapp.net".
Respuesta estándar (200)
Ambas rutas devuelven un envoltorio con elcallId asignado por WhatsApp:
duration (segundos que estuvo sonando).
El
callId identifica la llamada en WhatsApp. La llamada fake la termina automáticamente el servidor tras duration segundos; la llamada con audio solo reproduce el archivo si el destinatario atiende.Errores comunes
Envoltorio de error:
Próximos pasos
Llamada Fake
Hace sonar el teléfono unos segundos y cuelga sola.
Llamada con Audio
Llama y reproduce un audio (URL o base64) al atender.
Crear Enlace de Llamada
Crea un enlace de llamada compartible (audio o video) que cualquiera puede abrir.
Previsualizar Enlace de Llamada
Consulta los metadatos de un enlace de llamada sin unirse a la llamada.
Programar Llamada
Crea un enlace y envía una tarjeta de evento con el enlace, título y hora de inicio.