Notificaciones de resumen de llamada de voz

Recibe un resumen estructurado tras cada llamada de voz por email, WhatsApp o un webhook personalizado. Esta guía explica cómo habilitar cada método, la plantilla de WhatsApp que usamos y cómo integrar el webhook con Zapier y Make.

Habilitar las notificaciones en el panel

1. Abre la app y ve a: Voz → Configuración
2. En "Notificaciones de resumen", elige una de estas opciones:
   • Email
   • WhatsApp
   • Webhook (POST)
3. Si eliges Webhook, introduce tu URL HTTPS (p. ej., https://ejemplo.com/resumen-voz)
4. Haz clic en "Guardar configuración"

Nota: los resúmenes solo se envían cuando una conversación tiene contenido suficiente y se puede generar un resumen.

Métodos de entrega

Email

Te enviaremos un email a la dirección de tu cuenta registrada con el resumen y los detalles clave de la llamada.

WhatsApp (mensaje de plantilla)

Enviamos un mensaje de WhatsApp con plantilla a tu número de teléfono de la cuenta.

Parámetros (en orden):

1. Número de teléfono del llamante
2. Fecha y hora de inicio de la llamada (localizada)
3. Resumen rápido
4. Puntos de acción (separados por •)
5. Urgencia

Requisitos y notas:

• Tu cuenta debe tener un número de teléfono válido configurado (Perfil → Número de teléfono).
• El mensaje se envía en el idioma de tu cuenta. Asegúrate de que tu plantilla es compatible con el idioma que has configurado.
• Este es un resumen conciso; para todos los detalles, usa el webhook.

Webhook (HTTP POST)

Haremos un POST con un payload JSON a tu URL después de que la llamada se complete y se genere el resumen.

• Método: POST
• Content-Type: application/json
• Timeout: 10s
• Reintentos: ninguno (los errores se registran)

Ejemplo de payload:

{
  "type": "voice.conversation.completed",
  "userId": "66f123abc456def789012345",
  "conversationId": "6700aa11bb22cc33dd44ee55",
  "phoneNumber": "+34612345678",
  "startedAt": "2025-09-02T14:23:11.123Z",
  "updatedAt": "2025-09-02T14:25:49.987Z",
  "summary": {
    "quickSummary": "El llamante preguntó sobre disponibilidad de mesa para el viernes por la noche.",
    "actionPoints": [
      "Llamar de vuelta para confirmar el horario de la reserva",
      "Enviar el menú por WhatsApp"
    ],
    "sentiment": "positive",
    "tone": "professional",
    "urgency": "medium",
    "context": "Primera llamada de un cliente interesado en cenar para 4.",
    "contactExtracted": { "name": "Alex", "phone": "+34612345678" },
    "bookingExtracted": { "date": "2025-09-05", "time": "19:30" }
  },
  "metadata": {
    "language": "es-ES",
    "email": "usuario@ejemplo.com"
  }
}

Ejemplo mínimo con cURL para pruebas locales:

curl -X POST https://tu-servidor.com/resumen-voz \
  -H "Content-Type: application/json" \
  -d '{
    "type":"voice.conversation.completed",
    "userId":"test",
    "conversationId":"test",
    "summary": {"quickSummary":"Hola"},
    "metadata": {"language":"es-ES"}
  }'

Recomendaciones de seguridad:

• Aloja tu endpoint en HTTPS.
• Opcionalmente, incluye un secreto en la URL (p. ej., https://ejemplo.com/resumen-voz?token=...) o implementa tu propia lógica de verificación.
• Aplica límites de velocidad y valida la estructura del JSON en tu lado.

Ejemplo de integración con Zapier

Crea un Zap para capturar el webhook y enrutar los datos a tus herramientas (p. ej., Gmail, Slack, Google Sheets).

1. En Zapier, crea un nuevo Zap
2. Trigger: "Webhooks by Zapier" → "Catch Hook"
3. Zapier te dará una URL personalizada. Cópiala
4. En la app, establece Notificaciones de resumen = Webhook y pega la URL de Zapier
5. Realiza una llamada de prueba para generar un payload (o envía un POST de prueba desde tu servidor)
6. De vuelta en Zapier, haz clic en "Test trigger" y revisa el payload de muestra
7. Añade un paso de Acción (ejemplos):
   • Gmail → "Send Email"
     • Asunto: "Nuevo resumen de llamada: {{quickSummary}}"
     • Cuerpo: incluye summary.quickSummary, une summary.actionPoints y phoneNumber
   • Google Sheets → "Create Spreadsheet Row"
     • Columnas: conversationId, phoneNumber, quickSummary, urgency, startedAt
   • Slack → "Send Channel Message"
     • Mensaje: breve resumen + puntos de acción

Consejos para el mapeo de campos:

• quickSummary → summary.quickSummary
• actionPoints (array) → usa el formateador de Zap para unir con •
• urgency → summary.urgency
• teléfono de contacto → phoneNumber

Ejemplo de integración con Make (Integromat)

Construye un escenario que capture el webhook y lo distribuya a tus apps.

1. Crea un escenario
2. Añade módulo: "Webhooks" → "Custom webhook" → Add → Copia la URL
3. En la app, establece Notificaciones de resumen = Webhook y pega la URL
4. Ejecuta el escenario una vez (en escucha)
5. Realiza una llamada de prueba para enviar un payload de muestra
6. Añade los siguientes módulos (ejemplos):
   • JSON → acción Parse (opcional; Make analiza el JSON automáticamente)
   • Google Sheets → Add row con conversationId, summary.quickSummary, summary.urgency
   • Slack / Microsoft Teams → Post message con el resumen
7. Mapea los campos del bundle del webhook entrante (p. ej., summary.actionPoints[])

Solución de problemas

• No se recibe ninguna notificación:

  • Asegúrate de que la llamada contenía suficientes mensajes para generar un resumen
  • Verifica el método seleccionado y, para webhook, que la URL es accesible (sin 4xx/5xx)
  • Comprueba los registros de tu servidor; enviamos un único POST con un timeout de 10s

• La plantilla de WhatsApp no llega:

  • Asegúrate de que el número de teléfono de tu perfil está configurado
  • Confirma que tu idioma coincide con una versión localizada de la plantilla

• Errores de validación del webhook en tu lado:

  • Registra el cuerpo de la petición y las cabeceras sin procesar
  • Compara con el payload de ejemplo anterior y relaja las comprobaciones de esquema estrictas si es necesario

---

Si necesitas ayuda para configurar las notificaciones o personalizar el payload, contacta con soporte en hello@wasapia.com.