Listar websites en Crisp, con una API
Lista 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.
- Identificador
- crisp_list_websites
La llamada
POST https://connect.reportei.com/api/tools/crisp_list_websites/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"page_number": 1
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| page_number | integer | Sí | Page number, starting at 1. |
Conexiones posibles
Tu cliente conecta su cuenta de Crisp una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
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.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/crisp_list_websites. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Crisp
- 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.
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.
