Fin Agent

Access Fin programmatically via the Fin Agent API endpoints.

Operations

MethodEndpointDescription
POST/fin/startStart a conversation with Fin
POST/fin/replyReply to Fin
POST/fin/csatSubmit a CSAT rating
POST/fin/capabilitiesDiscover Fin's capabilities
POST/fin/askAsk Fin
POST/fin/procedures/{procedure_id}/runRun a Fin procedure
POST/fin/escalateEscalate to a human

Example

Start a conversation with Fin, with the TypeScript SDK:

ts
import { Intercom } from "@octridev/intercom";

const client = new Intercom({
  // Optional: replaces the default server and any server an operation declares.
  baseUrl: "https://api.intercom.io",
  auth: { bearerAuth: process.env.API_TOKEN! },
});

const result = await client.finAgent.startFinConversation({
  conversationId: "conversation-1",
  message: {},
  user: {},
});
console.log(result);
Nine more languages

The same call exists in every SDK. See SDKs for the other nine.