integrations

Open a support conversation in the desktop app (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
POST /clients/send-intercom-signal
Access token

Super admin only: tells every online desktop app signed in with the extraction code to open the given support conversation. Returns 404 when no app on that code is online.

application/json

Body Required

  • extractionCode string Required

    The extraction code

  • type string Required

    The log type

    Value is open_conversation.

  • conversationId string

    The conversaton ID

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • message string Required
      • isSuccess boolean Required
    • statusCode number Required
    • timestamp string(date-time) Required
POST /clients/send-intercom-signal 
curl \
 --request POST 'http://api.example.com/clients/send-intercom-signal' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "extractionCode": "string",
  "type": "open_conversation",
  "conversationId": "64a7672e5462512345678901"
}'
Request examples 
{
  "extractionCode": "string",
  "type": "open_conversation",
  "conversationId": "64a7672e5462512345678901"
}
Response examples (201) 
{
  "data": {
    "message": "Done",
    "isSuccess": true
  },
  "statusCode": 201,
  "timestamp": "2026-01-15T10:15:00.000Z"
}