Webhooks: envía eventos de Piper a tu propio endpoint

Los Webhooks te permiten enviar eventos de Piper directamente a tu propio endpoint, sin necesidad de una cuenta de Zapier. Esta función está disponible para Super Admins en Settings → Integrations → Webhooks.

¿Prefieres llegar a más de 8000 aplicaciones sin escribir tu propio endpoint? Consulta Zapier.

Requisitos previos

Una cuenta Super Admin en Piper
Un endpoint HTTPS capaz de recibir solicitudes POST

Configurar un webhook

Agrega un webhook

Haz clic en + Add webhook e indica un Name y una URL de destino (debe ser https://).

Elige los tipos de evento

Selecciona los eventos que deben activar este webhook: AI Transcription & Notes, CRM Fields o Call Scoring Value. Puedes seleccionar más de uno.

Agrega encabezados personalizados (opcional)

Agrega los encabezados personalizados que tu endpoint necesite, como pares clave/valor repetibles.

Guarda y verifica

Guarda el webhook. Piper muestra un signing secret que puedes usar para verificar que cada solicitud proviene realmente de Piper — cada envío está firmado (Standard Webhooks/HMAC) y puede rotarse en cualquier momento desde la misma pantalla.

Entrega y seguridad

Los envíos solo se realizan a URLs HTTPS.
Cada solicitud está firmada con el esquema Standard Webhooks/HMAC, lo que permite verificar que proviene de Piper.
Los envíos fallidos (tiempos de espera agotados o errores del servidor) se reintentan automáticamente.
Rota el signing secret en cualquier momento desde la misma pantalla si sospechas que fue comprometido.

Esquema del payload

Cada envío es el mismo sobre JSON, que contiene una de tres formas de data según type:

{
  "id": "de305d54-...",            // id estable, también enviado en el encabezado webhook-id
  "type": "extracts",              // "extracts" | "deal_values" | "call_score"
  "timestamp": "2026-09-22T10:00:00+00:00",
  "data": { /* ver a continuación */ }
}

extracts (AI Transcription & Notes):

{
  "url": "string",
  "recording_url": "string | null",
  "summary": "string",
  "meeting_type_name": "string | null",
  "activity": {
    "id": "string", "title": "string", "description": "string | null",
    "start_date": "ISO 8601", "end_date": "ISO 8601",
    "contacts": [{ "email": "string | null", "display_name": "string | null" }]
  },
  "transcription": { "sentences": [{ "time": "string", "participant": "string", "sentence": "string" }] },
  "note": { "title": "string", "html_content": "string", "note_template_name": "string | null" },
  "follow_up_email": { "to": ["string"], "cc": ["string"], "subject": "string", "body": "string" },
  "custom_insights": [{ "label": "string", "values": ["string"] }]
}

deal_values (CRM Fields):

{
  "deal_id": "string",
  "deal_name": "string | null",
  "meeting_type_name": "string | null",
  "updated_values": [{ "property_name": "string", "property_label": "string", "values": ["string"] }]
}

call_score (Call Scoring Value):

{
  "url": "string",
  "activity": { /* misma forma que arriba */ },
  "meeting_type_name": "string | null",
  "call_score_template_name": "string",
  "score": "number | null",
  "prompts": [{ "name": "string", "description": "string", "explanation": "string | null", "weight": "number", "found": "boolean" }]
}

Cada objeto data también incluye un campo json_content: el mismo payload, codificado en base64, mantenido por compatibilidad con zaps de Zapier antiguos.

Para otra plataforma de automatización, o un caso de uso que requiera acceso API completo, consulta Zapier o contacta a support@piperai.com.

Primeros pasos

Funciones principales

Agentes de IA y Chat

Configuración

Seguridad y Privacidad

Solución de problemas

Webhooks: envía eventos de Piper a tu propio endpoint

Requisitos previos

Configurar un webhook

Entrega y seguridad

Esquema del payload

​Requisitos previos

​Configurar un webhook

​Entrega y seguridad

​Esquema del payload

Requisitos previos

Configurar un webhook

Entrega y seguridad

Esquema del payload