Ir al contenido principal

Disparadores proactivos de procedimientos: clic en elemento del sitio web y API

Cómo activar procedimientos Fin desde un clic en un botón del sitio web o llamada externa a la API, incluyendo configuración, experiencia del cliente y comportamiento de enrutamiento. Función Beta.

Escrito por Dawn Perrott

Los procedimientos normalmente se activan por la intención del cliente: Fin compara lo que dice el cliente con los criterios de "Cuándo usar" de un procedimiento. Los disparadores proactivos permiten iniciar un procedimiento desde fuera de la conversación: cuando un cliente hace clic en un elemento específico de su sitio web, o cuando un sistema externo llama a la API de Intercom.

Nota: Los disparadores proactivos de procedimientos están en Beta. Contacte a su gerente de cuenta para acceso.

Experiencia del cliente

Cuando se activa un disparador proactivo:

  1. Fin envía el primer mensaje que configuró al cliente

  2. El procedimiento solo comienza después de que el cliente responde

  3. Si el cliente nunca responde, la conversación se cierra con un resultado Pendiente

Importante: Un resultado Pendiente no cuenta para su tasa de resolución. Los disparadores proactivos están diseñados para alcance — las métricas de resolución solo aplican una vez que el cliente interactúa y el procedimiento se ejecuta.

Enrutamiento después de la primera respuesta del cliente

Activar un procedimiento no garantiza que se ejecute. Después de la primera respuesta del cliente, Fin evalúa el mensaje y decide cómo proceder:

  • Fin sigue el procedimiento activado si no se aplica ninguna de las condiciones siguientes

  • Fin deja el procedimiento de lado si la respuesta solicita un agente humano

  • Fin deja el procedimiento de lado si la respuesta coincide con la intención de otro procedimiento

  • Fin deja el procedimiento de lado si puede responder con confianza a la respuesta usando contenido de ayuda

Nota: Diseñe sus flujos proactivos teniendo esto en cuenta: un procedimiento activado no garantiza su ejecución si la primera respuesta del cliente lleva a Fin en una dirección diferente.

Configurar un disparador de clic en elemento del sitio web

Los disparadores de clic en elemento del sitio web se activan cuando un cliente hace clic en un botón, enlace u otro elemento específico de su sitio web.

Importante: Este disparador está disponible solo en web (Messenger). El Messenger debe estar instalado en la página donde aparece el elemento.

  1. Abra el procedimiento en el editor

  2. Vaya a Cuándo usar (disparador) > Disparadores proactivos

  3. Seleccione Clic en elemento del sitio web

  4. Ingrese la URL de la página y haga clic en Examinar y seleccionar para elegir el elemento

  5. Configure el primer mensaje de Fin — esto es obligatorio y es lo que Fin envía cuando se activa el disparador

  6. Configure los ajustes de despliegue para lo que sucede después de que termina el procedimiento

Configurar un disparador de llamada API

Los disparadores de llamada API permiten que un sistema externo inicie un procedimiento programáticamente.

Nota: Este disparador soporta canales web (Messenger) y correo electrónico. Por defecto usa web si no se especifica canal.

Prerrequisitos

  • Una aplicación Developer Hub con un token de acceso

  • El token debe tener el alcance write_conversations

Importante: Guarde su token de acceso en el servidor. Nunca lo incluya en código del lado del cliente donde podría exponerse.

Realizando la llamada API

  1. Abra el procedimiento en el editor

  2. Vaya a Cuándo usar (disparador) > Disparadores proactivos

  3. Seleccione llamada API — aquí se muestra la URL del endpoint específico del procedimiento

  4. Envíe una solicitud POST a esa URL con los encabezados y cuerpo abajo

  5. Configure el primer mensaje de Fin (obligatorio)

  6. Configure los ajustes de despliegue para después de que termina el procedimiento

Encabezados requeridos:

Authorization: Bearer {your-access-token}
Intercom-Version: Unstable

Importante: El encabezado Intercom-Version: Unstable es obligatorio. Este endpoint aún no está en una versión estable de la API — omitir este encabezado hará que la solicitud falle.

Cuerpo de la solicitud:

{
  "user": {
    "id": "your-user-id"
  }
}

Respuesta exitosa

Una solicitud exitosa devuelve conversation_id y procedure_id:

{
  "conversation_id": "...",
  "procedure_id": "..."
}
¿Ha quedado contestada tu pregunta?