Send conversations from any tool
If your support tool isn't one Ferndesk connects to, publish your conversations as JSON at a URL and connect it as a Support endpoint. Fern reads them like any other support tool, to find questions your docs miss. Use your support tools as a source explains what Fern does with them.
Ferndesk pulls from your URL: it sends a GET to it, and never writes back. An owner or admin connects it in Integrations under Help desks by pasting the address as the Source URL. Connecting needs an active subscription or trial.
The request
GET https://example.com/support-endpoint.json?token=YOUR_SECRET&startDate=2026-11-20T02:00:00.000Z&limit=500Ferndesk keeps any query string already in your URL and adds:
Parameter | What it means |
|---|---|
| Return conversations with activity from this time on. A UTC ISO 8601 timestamp. Ferndesk doesn't filter the dates itself, so your endpoint must. |
| The most conversations to return. Daily syncs send 500. When Ferndesk checks the URL on connect it sends 1. |
Ferndesk sends no credentials. To protect the endpoint, put a long secret in the URL's query string and check it on your side.
The URL must resolve to a public address. Redirects are followed up to 5 times.
There are no pages: each sync is one request. Return the newest conversations first, because Ferndesk keeps only the first
limit.The response can be up to 25 MB.
The response
{
"conversations": [
{
"id": "conv_1042",
"url": "https://support.example.com/conversations/1042",
"lastMessageAt": "2026-11-20T14:32:00Z",
"messages": [
{
"id": 1,
"role": "user",
"content": "How do I export my invoices?",
"createdAt": "2026-11-20T14:05:00Z"
},
{
"id": 2,
"role": "support_agent",
"content": "<p>Go to Billing and choose Export.</p>",
"createdAt": "2026-11-20T14:32:00Z"
}
]
}
]
}Field | Rules |
|---|---|
| Required. A non-empty string that stays the same across syncs. |
| Optional. An absolute URL to the conversation in your tool. |
| Required. ISO 8601 with a timezone, such as |
| Required. A non-empty string or a whole number from 1. |
|
|
| Required. Plain text or simple HTML. Other tags are removed. |
| Required. ISO 8601 with a timezone. |
One conversation that breaks these rules fails the whole response, so validate before you return it. To report a problem on your side, return a top-level "error" string: Ferndesk treats the sync as failed.
When Ferndesk syncs
Right after you connect, Ferndesk checks the URL with
limit=1and a 10-second timeout. If the request fails or the JSON doesn't match, the connection isn't saved.The first sync asks for the last 90 days. After that, Ferndesk syncs once a day and asks for conversations since the last successful sync.
A sync that fails is retried once.
Imported conversations appear in Reporting > Topics, grouped by theme. Find and fill docs gaps each month covers what to do with them.