Webhooks

Los webhooks te permiten recibir notificaciones en tiempo real sobre eventos que ocurren en Salescaling. Cuando se produce un evento, Salescaling enviará una solicitud HTTP POST a la URL que hayas configurado.

Configuración de Webhooks

Para configurar un webhook, necesitas proporcionar:

• Nombre del webhook
• URL de destino
• Tipo de evento a escuchar
• Headers personalizados (opcional)
• Descripción (opcional)

Tipos de Eventos

Actualmente soportamos los siguientes tipos de eventos:

1. Cambios en el Estado de Reuniones (meeting_status_changed)

Este evento se dispara cuando hay cambios en el estado de una reunión. Los posibles estados son:

• meeting_created: Cuando se crea una nueva reunión
• meeting_deleted: Cuando se elimina una reunión
• meeting_transcript_done: Cuando se completa la transcripción
• meeting_summary_done: Cuando se completa el resumen
• meeting_video_done: Cuando se completa el procesamiento del vídeo
• meeting_notes_done: Cuando se completa el procesamiento de las notas

Payload

{
  "meetingId": "string",
  "status": "meeting_created" | "meeting_deleted" | "meeting_transcript_done" | "meeting_summary_done" | "meeting_video_done" | "meeting_notes_done"
}

Notas

• El procesamiento del vídeo y del contenido de la reunión se realiza de forma paralela, por lo que el evento meeting_video_done se puede recibir antes del evento meeting_summary_done.
• Si se quiere saber cuando se completa el procesamiento del contenido de la reunión, se puede utilizar el evento meeting_summary_done.
• Si se quiere saber cuando se completa el procesamiento de las notas, se puede utilizar el evento meeting_notes_done.

2. Cambios en Notas de Reuniones (meeting_note_status_changed)

Este evento se dispara cuando hay cambios en al menos una nota de una reunión. Los posibles estados son:

• meeting_note_created: Cuando se crea una nueva nota
• meeting_note_deleted: Cuando se elimina una nota
• meeting_note_updated: Cuando se actualiza una nota

Payload

{
  "meetingNoteId": "string",
  "status": "meeting_note_created" | "meeting_note_deleted" | "meeting_note_updated"
}

Notas

• Este evento se dispara una vez por cada nota que se procese.
• Al generarse notas de forma automática, se dispara este evento para cada nota generada.

3. Detección de Señales Comerciales (commercial_signal_detected)

Este evento se dispara cuando se detecta una señal comercial en una actividad. Las señales comerciales son indicadores importantes que pueden ayudar a identificar oportunidades o riesgos en las interacciones con clientes.

Payload

{
  "code": "string",
  "description": "string",
  "contactId": "string",
  "companyId": "string",
  "activityType": "string",
  "activityId": "string",
  "evidence": ["string"],
  "changeType": "string"
}

Campos

• code: Código de la señal comercial detectada. Los tipos disponibles son:

  • Engagement & Intent:

    • buying_intent: Intención de compra detectada
    • interest_in_trial: Interés en realizar una prueba
    • opportunity_qualified: Oportunidad calificada
    • champion_detected: Detección de un campeón interno
    • gatekeeper_detected: Detección de un guardián
    • future_meeting_scheduled: Reunión futura programada
    • decision_timeline_mentioned: Mencionada línea temporal de decisión
    • follow_up_required: Se requiere seguimiento
    • follow_up_deadline_mentioned: Mencionado plazo de seguimiento
    • multi_department_involvement: Involucrados múltiples departamentos

  • Pricing, Budget & Negotiation:

    • pricing_discussed: Discusión sobre precios
    • budget_blocker: Bloqueo por presupuesto
    • budget_discussed: Discusión sobre presupuesto
    • discount_requested: Solicitado descuento
    • contractual_concerns: Preocupaciones contractuales
    • legal_process_discussed: Discusión sobre proceso legal
    • renewal_discussed: Discusión sobre renovación
    • upsell_opportunity: Oportunidad de upsell
    • pilot_success: Éxito del piloto
    • pilot_failure: Fracaso del piloto

  • Fit & Product:

    • product_fit_confirmed: Confirmado ajuste del producto
    • usage_feedback_positive: Feedback positivo de uso
    • usage_feedback_negative: Feedback negativo de uso
    • technical_validation_passed: Pasada validación técnica
    • technical_blocker: Bloqueo técnico
    • integration_concerns: Preocupaciones sobre integración
    • training_requested: Solicitado entrenamiento
    • feature_request_made: Solicitada nueva funcionalidad
    • security_concerns: Preocupaciones de seguridad
    • compliance_concern: Preocupación sobre cumplimiento

  • Competition:

    • competitor_mentioned: Mencionado competidor
    • competitor_comparison_favorable: Comparación favorable con competidor
    • competitor_comparison_unfavorable: Comparación desfavorable con competidor

  • Risk & Churn:

    • churn_risk: Riesgo de abandono
    • no_decision_maker: Sin tomador de decisiones
    • internal_disalignment: Desalineación interna
    • resistance_to_change: Resistencia al cambio
    • escalation_detected: Detectada escalada
    • low_engagement: Bajo compromiso
    • deadline_blocker: Bloqueo por plazo

  • Relationship & Communication:

    • positive_feedback_on_demo: Feedback positivo en demo
    • negative_feedback_on_demo: Feedback negativo en demo
    • rapport_detected: Detectado rapport
    • misalignment_on_goals: Desalineación en objetivos
    • client_asks_many_questions: Cliente hace muchas preguntas
    • client_confused_about_offering: Cliente confundido sobre la oferta
    • tone_aggressive: Tono agresivo
    • tone_passive: Tono pasivo
    • speaker_dominates_conversation: El hablante domina la conversación
    • client_drives_conversation: El cliente dirige la conversación

• description: Descripción detallada de la señal

• contactId: ID del contacto relacionado

• companyId: ID de la empresa relacionada

• category: Categoría de la señal comercial. Los tipos disponibles son:

  • positive: Señal positiva
  • risk: Señal de riesgo
  • neutral: Señal neutral

• activityType: Tipo de actividad donde se detectó la señal. Los tipos disponibles son:

  • meeting: Reunión
  • call: Llamada
  • mail: Correo electrónico

• activityId: ID de la actividad donde se detectó la señal

• evidence: Array de evidencias textuales que soportan la detección de la señal

• changeType: Tipo de cambio que representa la señal. Los tipos disponibles son:

  • new: Nueva señal detectada
  • unchanged: Señal sin cambios
  • escalated: Señal escalada
  • improved: Señal mejorada
  • recovered: Señal recuperada

Estructura de la Solicitud

Cada solicitud webhook incluye:

1. Headers:

   • Content-Type: application/json
   • Headers personalizados configurados
   • X-Webhook-Signature: Firma para verificar la autenticidad (próximamente)

2. Body:

   • Definido según el tipo de evento

Mejores Prácticas

1. Verificación de Payload:

   • Implementa la verificación de la firma del webhook (Próximamente)

2. Manejo de Errores:

   • Responde con un código 2xx para confirmar la recepción
   • Implementa reintentos en caso de fallos
   • Mantén un registro de los eventos recibidos

3. Seguridad:

   • Utiliza HTTPS para tu endpoint
   • Implementa autenticación en tu endpoint, puedes especificar un token en las cabeceras de la solicitud
   • Valida los datos recibidos antes de procesarlos

Ejemplo de Implementación

app.post("/webhook", (req, res) => {
  const { type, payload } = req.body;

  switch (type) {
    case "meeting_status_changed":
      handleMeetingStatusChange(payload);
      break;
    case "meeting_note_status_changed":
      handleMeetingNoteStatusChange(payload);
      break;
  }

  res.status(200).send("OK");
});

Límites y Restricciones

• Los webhooks tienen un tiempo de espera de 10 segundos
• Se realizarán hasta 3 reintentos en caso de fallo
• El tamaño máximo del payload es de 1MB

Soporte

Si necesitas ayuda con la implementación de webhooks o tienes preguntas sobre los eventos disponibles, contacta con nuestro equipo de soporte.