# Crisp

Manage Crisp live chat: conversations, messages, people, operators, sessions. Exposes **16 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `crisp_list_conversations` | List all conversations - GET /website/{website_id}/conversations. |
| `crisp_get_conversation` | Get one conversation - GET /website/{website_id}/conversation/{session_id}. |
| `crisp_initiate_conversation` | Initiate a new conversation - POST /website/{website_id}/conversation. |
| `crisp_archive_conversation` | Archive a conversation - PATCH /website/{website_id}/conversation/{session_id}. |
| `crisp_send_message` | Send a message in a conversation - POST /website/{website_id}/conversation/{session_id}/message. |
| `crisp_list_messages` | List messages in a conversation - GET /website/{website_id}/conversation/{session_id}/messages. |
| `crisp_get_message` | Get one message - GET /website/{website_id}/conversation/{session_id}/message/{message_id}. |
| `crisp_get_people_profile` | Get a customer profile - GET /website/{website_id}/people/{people_id}. |
| `crisp_update_people_profile` | Update a customer profile - PATCH /website/{website_id}/people/{people_id}. |
| `crisp_list_people_profiles` | List all customer profiles - GET /website/{website_id}/people. |
| `crisp_list_operators` | List support operators - GET /website/{website_id}/operators. |
| `crisp_get_operator` | Get one operator - GET /website/{website_id}/operator/{operator_id}. |
| `crisp_invite_operator` | Invite a new operator - POST /website/{website_id}/operators. |
| `crisp_delete_operator` | Delete an operator - DELETE /website/{website_id}/operator/{operator_id}. |
| `crisp_get_website_settings` | Get website settings - GET /website/{website_id}/settings. |
| `crisp_update_website_settings` | Update website settings - PATCH /website/{website_id}/settings. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`CRISP_IDENTIFIER`** - Crisp Marketplace - create a token - identifier. (https://marketplace.crisp.chat/)
- **`CRISP_KEY`** - Secret key paired with the identifier.
- **`CRISP_WEBSITE_ID`** - Crisp - Settings - Website settings - Website ID (UUID).

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `CRISP_IDENTIFIER` | Crisp Marketplace - create a token - identifier. |
| `CRISP_KEY` | Secret key paired with the identifier. |
| `CRISP_WEBSITE_ID` | Crisp - Settings - Website settings - Website ID (UUID). |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Crisp API documentation](https://docs.crisp.chat/references/rest-api/v1/)