Conversation APIs and Webhooks

Freshchat now has a comprehensive set of conversation APIs and associated webhooks. You can customize and extend Freshchat ’s core conversation workflows through these APIs. For example, you can use the APIs to integrate with a custom bot platform/your own bot, sync to an external CRM to push and pull data, or even connect your own widget/front end to the Freshchat agent backend.


Supported Interactions

  • Quick reply buttons
  • URL Buttons
  • Web Views
  • Images
  • GIFs
  • Drop-downs and Carousels


How does this interaction happen?

Interaction from your side will be sent to Freshchat through the APIs. And Freshchat will respond back by using Webhooks when certain events happen (eg: new user messages).


For a list of supported APIs, refer to our API documentation.


Here is the list of supported contacts and marketing lists. 


For webhooks, refer to the webhooks article.


Sample Use Case

For example, consider this scenario of a fictional bank called AG bank.



When a customer sends a message, your custom bot (let's call it ‘Freddy’) starts engaging with them. With the interactive button element, you can display multiple options to the user. Here, the customer chooses to view their account statement, and the bot asks for card details. Once the customer clicks card details, with the web view option, you can load your website or the particular HTML page right within the widget where the user can enter their details (securely - Freshchat cannot see or access this information, it entirely resides on your side) and check their account statement. Post this, you or the customer can close the page, and the customer will be redirected to the conversation flow, and the bot will resume the interaction. This is completely secure, and Freshchat won’t be able to read the customer information. 


The above example is just one use case. With customized Freshchat APIs, the possibilities are endless.


Set up

You can generate API Key by going to Admin > API Tokens. Refer to this article. For the Webhook Settings, you can go to Admin >Webhooks and configure your preferences. Refer to the webhooks article for more information on webhook events and authenticating webhook calls.