Saltar al contenido principal
Auth: TokenAccount o TokenInstance • Rate-limit: Global (100/min) • Idempotente: no El módulo /api/call/* cubre el inicio de llamadas de voz desde la instancia. Actualmente hay dos operaciones: la llamada fake, que hace sonar el teléfono unos segundos y cuelga sola (sin audio), y la llamada con audio, que llama y reproduce un archivo cuando el destinatario atiende. Todas las rutas validan la propiedad de la instancia y aceptan TokenAccount o TokenInstance.

​
Endpoints disponibles

MétodoPathTipo
POST/api/call/fake/:instanceLlamada Fake
POST/api/call/audio/:instanceLlamada con Audio

​
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".
Las llamadas son siempre 1:1 — no hay llamada a grupo vía API.

​
Respuesta estándar (200)

Ambas rutas devuelven un envoltorio con el callId asignado por WhatsApp: 
{
  "success": true,
  "message": "Audio call placed",
  "callId":  "3EB08FCF27E532F1D3D3",
  "number":  "5511999999999"
}
La llamada fake incluye además el campo 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

HTTPMensaje
400Instance name is required
400Invalid request body: <detail>
400Number is required
400Duration must be between 1 and 60 seconds (fake)
400Provide exactly one of mediaUrl or mediaBase64 (audio)
404instance not found
500<motivo del fallo>
Envoltorio de error: 
{
  "success": false,
  "error": { "message": "Number is required" }
}

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