> ## Documentation Index
> Fetch the complete documentation index at: https://docs.minidesk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Make

> Run Make scenarios when conversations arrive or change.

Make (formerly Integromat) reaches miniDesk through its built-in **Webhooks**
and **HTTP** apps, with the same [webhooks](https://docs.minidesk.ai/guides/webhooks.md) and
[API](https://docs.minidesk.ai/api-reference/introduction.md) as any integration.

## Start a scenario on a miniDesk event

1. In Make, add the **Webhooks → Custom webhook** module as the trigger, and
   copy the address Make gives it.
2. In miniDesk, go to **Settings → Webhooks**, choose **Add webhook**, paste
   the address and pick the events: new conversation, new customer message,
   status changed, assigned.
3. Back in Make, choose **Redetermine data structure**, then in miniDesk open
   the webhook and choose **Send test event**. Make now knows the fields.

Every event has the same envelope: `type`, `created_at` and `data`, with
`data.conversation`, `data.message`, `data.change` and `data.actor`. The
[webhooks guide](https://docs.minidesk.ai/guides/webhooks.md) lists what each event carries.

To check that a call really came from miniDesk, compare the
`miniDesk-Signature` header with the webhook's secret, as the
[webhooks guide](https://docs.minidesk.ai/guides/webhooks.md#verifying-the-signature) shows.

> [!TIP]
>
> To get a real conversation's fields instead of the test event's, call
> `GET /v1/webhooks/samples?event=conversation.created` with your API key. It
> answers your three latest conversations in the shape a delivery has.

## Act in miniDesk from a scenario

Use **HTTP → Make a request** with your API key from **Settings → API**:

* **Headers**: `Authorization: Bearer <your key>`.
* **Body type**: Raw, JSON.

| To | Method and URL | Body |
| - | - | - |
| Reply to the customer | `POST https://api.minidesk.ai/v1/tickets/{id}/messages` | `{ "body": "…", "visibility": "public" }` |
| Add an internal note | `POST https://api.minidesk.ai/v1/tickets/{id}/messages` | `{ "body": "…", "visibility": "internal" }` |
| Change status or assignee | `PATCH https://api.minidesk.ai/v1/tickets/{id}` | `{ "status": "resolved" }` |
| Create or update a customer | `PUT https://api.minidesk.ai/v1/customers` | `{ "email": "…", "name": "…" }` |

A public reply reaches a real person and cannot be unsent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.