Ringostat
Entrar

Lanzar llamadas desde código (API)

~6 min · Un ejemplo completo: crear → añadir números → iniciar → resultados.

Un ejemplo completo por MCP. Las llamadas van en un sobre tools/call después de initialize (consulta «Autorización»).

1. Crear una campaña: voiceagent_create_campaign con "pause": true. Una campaña nueva está activa desde el principio: sin pause empieza a llamar en cuanto se añaden números. La respuesta es el objeto de la campaña; su id es el campaignID de las siguientes llamadas. type es el tipo de campaña como lo nombra la interfaz: simple («Informational Call»), aisdr («Voice Agent») o multi_question_dtmf («Interactive Survey»).

{"name":"voiceagent_create_campaign","arguments":{
  "projectID":217, "name":"Confirmación de pedidos", "type":"simple",
  "language":"es-ES", "text":"¡Hola! Le llamo para confirmar su pedido. ¿Está todo correcto?",
  "voiceName":"<VoiceID de voiceagent_get_voices>", "endpoint":"<tu_SIP>",
  "maxAttempts":3, "simultaneousCalls":3,
  "webhookURL":"https://your-app.example/webhooks/ringostat", "pause":true }}

2. Añadir números: voiceagent_add_numbers.

{"name":"voiceagent_add_numbers","arguments":{
  "projectID":217, "campaignID":799,
  "numbers":[ { "phone":"+34612345678", "customFields":{"name":"Juan"} } ] }}

3. Iniciar: voiceagent_update_campaign_field (field=paused, value="false").

{"name":"voiceagent_update_campaign_field","arguments":{
  "projectID":217, "campaignID":799, "field":"paused", "value":"false" }}

4. Resultados: voiceagent_get_campaign_stats (contadores) y voiceagent_list_campaign_numbers (estado e ID de cada número); transcripción e informe de una llamada: voiceagent_get_call_detail con numberID = ese ID; o directamente por webhooks.