Make - miniDesk AI

Make (formerly Integromat) reaches miniDesk through its built-in Webhooks and HTTP apps, with the same webhooks and API as any integration.

Start a scenario on a miniDesk event

In Make, add the Webhooks → Custom webhook module as the trigger, and copy the address Make gives it.
In miniDesk, go to Settings → Webhooks, choose Add webhook, paste the address and pick the events: new conversation, new customer message, status changed, assigned.
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 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 shows.

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.