Inicio rápido

​

En resumen

• Contrate un número ACTIVE, es la línea de origen (from).
• Origine con from, to y qué decir cuando respondan (speak, audio o gather).
• Seguimiento y control vía API o webhooks (voice.call.*).

​

Antes de empezar

• Número ACTIVE en el espacio de trabajo
• Clave con voice:call (y voice:read / voice:control según sea necesario)
• Saldo o créditos disponibles
• Autenticación: Authorization: Bearer sk_live_... o x-api-key
• URL base: https://api.notifique.dev
• Destinos en E.164 con + (por ejemplo, +5511999887766)

​

1. Originar una llamada

​

1A, a través del panel

1. Voz → Nueva llamada
2. Seleccione los números de origen y destino
3. Configure el mensaje (TTS o audio) y envíe

​

1B, a través de API

POST /v1/voice/calls
Content-Type: application/json
Authorization: Bearer sk_live_xxxxx

{
  "from": "+5511987654321",
  "to": ["+5511999887766"],
  "type": "speak",
  "payload": {
    "text": "¡Hola! Esta es una llamada de prueba de Notifique.",
    "voice": "female-natural"
  },
  "clientState": "campana-verificacion-42"
}

{
  "success": true,
  "data": {
    "id": "clvoice1...",
    "direction": "OUTBOUND",
    "fromE164": "+5511987654321",
    "toE164": "+5511999887766",
    "status": "QUEUED",
    "clientState": "campana-verificacion-42",
    "createdAt": "2025-02-15T10:00:00.000Z"
  }
}

• type: "play", reproducir audio por URL: payload.audioUrl
• type: "gather", recoger DTMF: payload.gather con prompt, maxDigits, timeoutSecs
• type: "template", plantilla del workspace: payload.templateId + variables opcionales
• record: true, graba la llamada
• machineDetection: "detect", detecta buzón de voz

​

2. Listar y consultar

​

3. Controlar llamada activa

​

4. Descargar grabación

​

5. Llamadas entrantes

1. Configure inboundVoiceAction en el número: Números de teléfono
2. Con WEBHOOK_CONTROL, recibe voice.call.received y control vía API
3. Con FORWARD, reenvía a forwardToE164
4. Con TTS_HANGUP, pronuncia el texto configurado y cuelga

​

6. Webhooks (opcional)

​

Voces TTS

​

Todos los tipos de envío

​

Próximos pasos

• Introducción: cuándo usar y ciclo de vida de la llamada
• Ámbitos: permisos de clave
• Eventos de webhook: estado en tiempo real
• Facturación: costo por minuto