Saltar al contenido principal
El assistant requiere un plan Pro o Enterprise.
Cuando el assistant no puede responder una pregunta a partir de tu documentación, puede derivar al usuario a tu equipo. Los usuarios obtienen una forma de contactar con una persona en lugar de llegar a un callejón sin salida. Elige a dónde van las preguntas de soporte en el menú Support de la sección Manejo de respuestas, en la página Assistant de tu dashboard: Si usas un help desk distinto de Plain o Zendesk, usa Link para enviar a los usuarios a su página de contacto o a su centro de ayuda.

Enviar preguntas por correo

En el menú Support, selecciona Email y luego introduce una o ambas direcciones:
  • Support email: Para preguntas que el assistant no pueda resolver a partir de tu documentación.
  • Ventas: Para preguntas sobre precios, planes o compras.
Cuando el assistant detecta una pregunta que coincide, aparece un formulario de contacto dentro del chat. El formulario solicita el nombre, los apellidos, la empresa, el correo corporativo y un mensaje del usuario. Mintlify envía la información por correo al equipo correspondiente, que puede responder directamente al correo del usuario. El mismo formulario de contacto está disponible en el widget del assistant integrado en otros sitios.
Si prefieres dirigir las preguntas de soporte a tus canales existentes, desactiva Contact form en la sección Manejo de respuestas.Cuando desactivas el formulario de contacto, el assistant dirige a los usuarios a tu dirección de correo de soporte como texto plano en lugar de mostrar el formulario dentro del chat. Las preguntas de ventas siguen usando el formulario dentro del chat cuando configuras un correo de ventas.
En el menú Support, selecciona Link para enviar a los usuarios a tu plataforma de soporte existente, como un centro de ayuda, un portal de tickets o un foro de la comunidad, en lugar de recopilar el correo mediante un formulario dentro del chat. Introduce la URL completa de tu destino de soporte. La URL debe usar http o https y no puede incluir credenciales. Cuando el assistant detecte una pregunta de soporte, mostrará al usuario una tarjeta con un enlace a tu URL de soporte. Mintlify añade el ID del hilo del assistant como parámetro de consulta threadId para que tu herramienta de soporte pueda adjuntar la transcripción de la conversación al ticket resultante. Recupera la transcripción con el endpoint Obtener hilo de conversación del assistant. Con Link seleccionado, el assistant no muestra el formulario de contacto ni dirige las preguntas de ventas.

Crear tickets en Plain o Zendesk

El assistant puede registrar las solicitudes de soporte como tickets en Plain o Zendesk en lugar de enviarlas por correo. Antes de conectar Plain, crea una clave de API de Plain con estos permisos:
  • customer:create
  • customer:edit
  • customer:read
  • thread:create
  • thread:read
  1. En la sección Response handling del menú Support, selecciona Direct support ticketing.
  2. Selecciona una Ticketing platform: Plain o Zendesk.
  3. En la tarjeta de la plataforma, haz clic en Connect y completa la conexión en la ventana que se abre. Para Plain, usa la clave de API que creaste.
Mintlify guarda la creación directa de tickets de soporte solo después de que la plataforma se conecte. Hasta entonces, tu opción de soporte actual sigue activa. La conexión es una integración compartida para tu organización. Cuando el assistant detecta una pregunta de soporte, muestra el formulario de contacto dentro del chat. Mintlify crea un ticket en tu plataforma conectada a partir del envío. El ticket incluye los datos de contacto y el mensaje del usuario, además de hasta los tres primeros mensajes de la conversación con el assistant. Si la conversación es más larga, el ticket enlaza a la conversación completa en tu dashboard. Si guardaste una dirección de Ventas en Email, las preguntas de ventas siguen enviándose por correo a esa dirección. Si a la clave de API de Plain le falta alguno de los permisos requeridos, la tarjeta de la plataforma muestra Scopes misconfigured. Haz clic en Configure para ver qué permisos faltan y, a continuación, agrégalos a la clave de API en Plain.