Freshchat integration | Zervanor
← All connectors

Freshchat

Also an agent tool
support

Freshworks Freshchat (API v2): create and manage conversations, send and list messages, manage users, read agents/groups/channels/roles, run report exports, send outbound WhatsApp campaigns, upload files/images, and collect CSAT. Per-account subdomain base URL with Bearer API-token auth. Change notifications use polling (users list); Freshchat webhooks carry no HMAC signature that maps to a supported handler and are documented for reference.

28 actions · 1 triggers

The Freshchat integration lets you connect Freshchat to your automations with 28 actions and 1 triggers — and every action is also a tool an AI agent can call. Examples: Get Account Configuration, Create User, List Users, Get User, Update User. No blank-canvas wiring — connect it and use it in your workflows.

Every action below is also a tool an AI agent can call — the same pack powers your workflows and your agents.

Triggers 1

Events in Freshchat that can start a workflow.

polling

New Freshchat users (polled)

Polls GET /users on a schedule, paging with page / items_per_page and deduping on user id. Freshchat webhooks carry no supported HMAC signature, so polling is the change-notification path.

Actions 28

What Zervanor can do in Freshchat.

Conversations6

POST

Create Conversation

Create a conversation (POST /conversations). Supply users[] (participant) and an optional initial messages[] array and channel_id.

GET

Get Conversation

Retrieve a conversation by id (GET /conversations/{conversation_id}).

PUT

Update Conversation

Update a conversation (PUT /conversations/{conversation_id}) — resolve/reopen (status) and assign/reassign to an agent and/or group.

GET

List Conversation Messages

List messages in a conversation (GET /conversations/{conversation_id}/messages). Offset pagination.

POST

Send Message

Send a message to a conversation (POST /conversations/{conversation_id}/messages). message_parts carry the content; actor identifies the sender.

GET

List Conversation Fields

List all conversation properties/fields (GET /conversations/fields).

Users6

POST

Create User

Create a user/contact (POST /users). Provide at least a reference_id or first_name; email/phone identify the user.

GET

List Users

List users by criteria (GET /users). Offset pagination via page / items_per_page. Filter by email, phone, or reference_id.

GET

Get User

Retrieve a single user by id (GET /users/{user_id}).

PUT

Update User

Update a user's details (PUT /users/{user_id}).

DELETE

Delete User

Delete a user (DELETE /users/{user_id}). Permanent (GDPR delete).

GET

List User Conversations

List a user's conversations (GET /users/{user_id}/conversations).

Agents3

GET

List Agents

List all agents (GET /agents). Offset pagination.

GET

Get Agent

Retrieve an agent by id (GET /agents/{agent_id}).

GET

List Agent Statuses

List all agent statuses / availability (GET /agents/status).

Metrics2

GET

Get Historical Metrics

Retrieve historical account metrics (GET /metrics/historical) for a time window.

GET

Get Instant Metrics

Retrieve current/instant account metrics (GET /metrics/instant).

Outbound Messages2

GET

List Outbound Messages

List outbound messages/campaigns (GET /outbound-messages). Offset pagination.

POST

Send Outbound WhatsApp Message

Send an outbound WhatsApp message (POST /outbound-messages/whatsapp) using an approved template.

Reports2

POST

Create Report

Request a raw report extract (POST /reports/raw). Returns a report id whose status is polled with Get Report; when complete the response carries download links.

GET

Get Report

Retrieve a report's status and, when ready, its download links (GET /reports/raw/{id}).

Accounts1

GET

Get Account Configuration

Retrieve the Freshchat account configuration (GET /accounts/configuration). Identity + connectivity probe.

Channels1

GET

List Channels

List all channels/topics (GET /channels). Offset pagination.

Csat1

POST

Create CSAT Rating

Create a CSAT (customer satisfaction) rating for a conversation (POST /csat/{conversation_id}).

Files1

POST

Upload File

Upload a file to Freshchat storage (POST /files/upload, multipart/form-data). Returns a URL to reference in a message.

Groups1

GET

List Groups

List all groups (GET /groups). Offset pagination.

Images1

POST

Upload Image

Upload an image to Freshchat storage (POST /images/upload, multipart/form-data). Returns a URL to reference in a message.

Roles1

GET

List Roles

List all roles (GET /roles).

Automations using Freshchat

Build your own automation with Freshchat in the visual builder.

Frequently asked questions

What can I automate with Freshchat?

28 actions are available — for example: Get Account Configuration, Create User, List Users, Get User, Update User, and more.

Which Freshchat events can start a workflow?

1 triggers — for example: New Freshchat users (polled).

Can Freshchat be used as an AI agent tool?

Yes. Every Freshchat action automatically becomes a tool an AI agent can call — the same pack powers both your workflows and your agents.

How is the Freshchat integration modelled?

Freshchat is modelled as a versioned connector pack, and the steps that need reasoning fall to first-party agents hosted in the same runtime as the workflows.