wechaty-freshdesk

Freshdesk is a cloud-based helpdesk system that offers powerful solutions for customer service.

Wechaty Freshdesk Plugin helps Freshdesk unifies conversations from WeChat, and helps you resolve issues across channels effortlessly!

Wechaty Plugin Freshdesk

Introduction

Wechaty Freshdesk Plugin helps you to manage your customers/leads/users in the WeChat Room, with the power of the Freshdesk service.

Requirements

Wechaty v0.40+
Freshdesk Garden Plan+ (for Assuming identities support)
Freshdesk config
1. Create two custom ticket fields
2. Create Webhook

Usage

import { WechatyFreshdesk } from 'wechaty-freshdesk'
const config = {
  contact: true,              // enable direct message.
  room: 'room_id@chatroom',   // enable a specific room. `true` for enable all room
  mention         : true,
  webhookProxyUrl : 'https://smee.io/your_smee_io_proxy_url',
  apiKey          : 'your_freshdesk_api_key',
  portalUrl       : 'https://your_portal_name.freshdesk.com',
}
const FreshdeskPlugin = WechatyFreshdesk(config)
const wechaty = new Wechaty()
wechaty.use(FreshdeskPlugin)

config.contact: Whether to allow direct message to be sync with ticket reply. false to deny all, true for allow all; Supports contact id(string) and contact name(RegExp). You can also mix them in array.
config.room: The room id of your service WeChat room.
config.mention: If set to true, customers need to use @ to mention the bot when they want to ask questions.
config.webhookProxyUrl: A smee.io link that you need to set it to receive the Freshdesk Webhook events.
1. smee.io - Webhook payload delivery service - Receives payloads then sends them to your locally running application.
config.apiKey: The API Key for your Freshdesk account.
1. Freshdesk API - How to find your API key

Configure Freshdesk Webhooks

In order to receive the reply and close events from Freshdesk, we need to configure the Freshdesk platform:

Add two custom ticket fields
Add a automation rule for Webhook

Note: Freshdesk Garden Plan (or above) is required, because we need Assuming identities feature.

1 Add Two Custom Ticket Field

Login to your Freshdesk agent account, from the menu on the left, select Admin, then select Ticket Fields under the General Settings.
Create two Single-line text fields:
1. Wechaty Room
2. Wechaty Contact

Freshdesk Ticket Fields

Doc: Creating custom fields in your ticket form

2 Go to Automation Setting Page

Login to your Freshdesk agent account, from the menu on the left, select Admin, then select Automations.
Below the Rules that run on, there will be three selections: Ticket Creation, Time Triggers, and Ticket Updates.

3 Create a `Ticket Updates` Rule

Freshdesk Automation Rule

Select Ticket Updates, click the New rule button.
Configure the rule as the following summary:
1. When Ticket is updated
2. When an action performed by Agent
3. When public Note is Added
  OR
  When Reply is Sent
4. Trigger Webhook Method - POST Url: https://smee.io/your_smee_io_proxy_url

And make sure you have configured the Webhook Content as the following:

Freshdesk Automation Rule

Ticket ID {{ticket.id}}
Last Public Comment {{ticket.latest_public_comment}}
Wechaty Room {{ticket.cf_wechaty_room}}
Wechaty Contact {{ticket.cf_wechaty_contact}}

Then click Preview and save.

Note: the POST Url must be as same as the webhookProxyUrl setting in the config.

See:

Environment Variables

The following two environment variables will be used if the required information is not provided by the config.

1 `WECHATY_PLUGIN_FRESHDESK_PORTAL_URL`

process.env.WECHATY_PLUGIN_FRESHDESK_PORTAL_URL will be used if the config.portalUrl is not provided.

2 `WECHATY_PLUGIN_FRESHDESK_API_KEY`

process.env.WECHATY_PLUGIN_FRESHDESK_API_KEY will be used if the config.apiKey is not provided.

Learn more about the authorization token of freshdesk: Freshdesk API - How to find your API key

3 `WECHATY_PLUGIN_FRESHDESK_WEBHOOK_PROXY_URL`

We receive webhook payloads with the help from , by proxy them to our locally running Wechaty Plugin application.

process.env.WECHATY_PLUGIN_FRESHDESK_WEBHOOK_PROXY_URL will be used if the config.webhookProxyUrl is not provided.

See:

smee.io - Webhook payload delivery service - Receives payloads then sends them to your locally running application.

Screenshot

Wechaty Freshdesk Conversation

Example

Our Friday BOT are using wechaty-freshdesk to connect our WeChat customers to Freshdesk.

You can read the source code from: https://github.com/wechaty/friday/blob/master/src/plugins/freshdesk.ts

History

master 1.0 (Oct 23, 2021)

Release 1.0 of Wechaty Freshdesk Plugin.

v0.6 Renamed from `wechaty-plugin-freshdesk` to `wechaty-freshdesk`

After the Freshdesk trail was end, we found that the following features are belonging to different plans:

Identifying contacts with an external ID requires Estate Plan
Assuming identities requires Garden Plan
Supported both direct message and room messages to be managed by freshdesk via tickets
use twitter_id as a workaround of unique_external_id
Change custom ticket fields on Freshdesk to store roomId and contactId from Wechaty
Change webhook setting on Freshdesk