Lister les conversations avec l'API Crisp

Liste les conversations d'un workspace, avec session_id, state, compteurs de non-lus, opérateur assigné, dernier message et le meta du visiteur (nickname, email, phone, segments). Les pages commencent à 1, et une page avec moins d'éléments que per_page est la dernière.

Identifiant
crisp_list_conversations

L'appel

POST https://connect.reportei.com/api/tools/crisp_list_conversations/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>",
    "page_number": 1
  }
}

Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.

Paramètres

Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.

ParamètreTypeObligatoireDescription
website_idstringOuiId of the workspace, from List websites.
page_numberintegerOuiPage number, starting at 1.
per_pageintegerNonConversations per page, from 20 to 50. Defaults to 20.
search_querystringNonText to search in the conversations when search_type is text, or the name of a segment when search_type is segment.
search_typestringNonHow search_query is read: text for a full text search, segment for the conversations tagged with that segment.Valeurs : text, segment
filter_unreadstringNon1 returns only conversations with unread messages.Valeurs : 0, 1
filter_resolvedstringNon1 returns only resolved conversations.Valeurs : 0, 1
filter_not_resolvedstringNon1 returns only conversations that are not resolved.Valeurs : 0, 1
filter_assignedstringNonReturns only the conversations assigned to this operator: the user_id inside details, from List operators.
filter_unassignedstringNon1 returns only conversations with no assigned operator.Valeurs : 0, 1
filter_date_startstringNonOnly conversations updated from this moment on, in ISO 8601, like 2026-10-01T00:00:00.000Z.
filter_date_endstringNonOnly conversations updated up to this moment, in ISO 8601.
order_date_createdstringNon1 orders by creation date instead of the default order.Valeurs : 0, 1
order_date_updatedstringNon1 orders by last update instead of the default order.Valeurs : 0, 1
order_date_waitingstringNon1 orders by the longest wait for an answer and leaves out the conversations that are not waiting.Valeurs : 0, 1
include_emptystringNon1 also returns conversations without any message. Defaults to 0.Valeurs : 0, 1

Connexions possibles

Votre client connecte son compte Crisp une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.

Identifiant et mot de passe

Votre client saisit les identifiants de l'app sur un écran de Connect, ou votre système les envoie avec POST /api/customer-toolkits, sans écran.

La réponse

En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.

Prête pour les agents IA

L'input de cette tool est un JSON Schema, disponible via GET /api/tools/crisp_list_conversations. Il devient la définition de tool de votre agent sans conversion.

Autres tools Crisp

Voir les 13 tools

Toolkits de la même catégorie

Voir les 100 toolkits

Voyez Connect appliqué à votre produit.

Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.