Atención al cliente
Crisp en tu producto y en tus agentes de IA, con una API
El toolkit de Crisp cubre websites (workspaces), conversaciones y sus mensajes, operadores y perfiles de personas: listar y leer conversaciones, enviar un mensaje o una nota interna, cambiar el estado, asignar un operador y crear o actualizar contactos. El cliente conecta con el token de su propio plugin de Crisp, y tu producto o agente de IA llama a cada operación por un único endpoint de Connect.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/crisp_send_message/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"website_id": "<website_id>",
"session_id": "<session_id>",
"type": "text",
"from": "operator",
"origin": "chat",
"content": "<content>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Crisp.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Crisp. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Crisp.
Bandeja de soporte en tu app
Lista conversaciones y sus últimos mensajes, y deja que tus usuarios respondan como operador o dejen una nota interna sin abrir Crisp.
Agente de IA que clasifica chats
Deja que un agente lea una conversación, la marque como pending o resolved y la asigne al operador correcto por user_id.
Contactos sincronizados con el CRM
Crea y actualiza perfiles de personas en Crisp con email, nombre y segmentos cuando un lead cambie en tu CRM, y léelos de vuelta por búsqueda.
Tools
13 tools de Crisp
- Listar websitesGETLista los workspaces de Crisp, llamados websites en la API, donde está instalado el plugin de este token, con su website_id. Obtener website da el nombre de cada uno. Las páginas empiezan en 1, y una lista data vacía indica que no hay más páginas.
- Obtener websiteGETDevuelve el nombre, el dominio y el logo de un workspace de Crisp, para distinguir los ids que devuelve Listar websites.
- Listar conversacionesGETLista las conversaciones de un workspace, con session_id, state, contadores de no leídos, operador asignado, último mensaje y el meta del visitante (nickname, email, phone, segments). Las páginas empiezan en 1, y una página con menos elementos que per_page es la última.
- Obtener conversaciónGETDevuelve una conversación con su estado, operador asignado, contadores de no leídos, último mensaje, people_id del contacto y el meta del visitante. Los mensajes vienen de Listar mensajes de la conversación.
- Listar mensajes de la conversaciónGETDevuelve el último lote de mensajes de una conversación, con type, sender, content y timestamp en milisegundos. Para paginar hacia los mensajes más antiguos, envía el timestamp del mensaje más antiguo del lote como timestamp_before.
- Enviar mensajePOSTEnvía un mensaje como operador en una conversación. El type text llega al visitante de inmediato; el type note es una nota interna que solo ven los operadores.
- Actualizar estado de la conversaciónPATCHCambia el estado de una conversación a pending, unresolved o resolved.
- Asignar conversaciónPATCHAsigna una conversación a un operador, que recibe una notificación salvo que silent sea true.
- Actualizar meta de la conversaciónPATCHActualiza los datos del visitante y el asunto o los segmentos de una conversación. Envía solo los campos a cambiar.
- Listar operadoresGETLista los operadores y las invitaciones pendientes de un workspace. Cada elemento tiene un type y un objeto details con user_id, email, name, role y availability; el user_id es lo que reciben la asignación, los filtros y las menciones.
Usuario y contraseña
Tu cliente ingresa las credenciales de la app en una pantalla de Connect, o tu sistema las envía con POST /api/customer-toolkits, sin pantalla.
Preguntas sobre el toolkit de Crisp
¿Necesito implementar la API de Crisp?
No. Connect ya trae 13 tools de Crisp descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Crisp?
Con el modo que acepta el toolkit: Usuario y contraseña. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
