API Triggers

1. Introduction

Forward integrations would allow you to create an automation flow in your chatbot that can be triggered by an API without the need of an end-user ever interacting with your chatbot. You can create a form asking for information from clients and pass them into the API via params into attributes and use them to perform functions based on the input and accomplish the goals.

2. Availability

Forward integrations are available in our Enterprise plans based on an entitlement, please reach out to info@engati.com for assistance.

3. Working Mechanism

When a user would enter information in a form and the API is triggered in which the user-inputs are passed as attributes via params then the flow will be executed, as an example in the below form my users would be entering the information and based on their category I would be generating and storing information in Salesforce and send out emails.

4. Functioning

4.1 Instructions for using the API

Method: Post

Request URL:

https://api.engati.com/bot-api/v1.0/customer/CID/bot/bot-key/flow/flowkey

Parameters:

Authorization: Basic API-Key



For WhatsApp, if in any case, the user's name is not present with its phone number then the 'user.user_name' attribute will capture and store its phone number.

CID – Customer Identifier will be available in the 'Integrations' tab > Engati API. Bot key – The bot key will be available in the 'Integrations' tab > Engati API. API Key – A key available in the 'Integrations' tab > Engati API that would be used for authentication purposes.



Flow key – The key of the flow which you would like to have initiated when the API request is made.

You can access it by clicking on the " i " (path info) icon present at the top of the respective path.



4.2 Creation of the flow



When the API will be triggered the attribute data will be passed through the API into the flow and this flow will be executed, as per your decision nodes and flows the process will be executed, so for example if I have a form that asks the end-users their category VIP or non VIP, then based on that the flow will be triggered and executed.

4.3 User tracking

When the API will be triggered and the automation flow executed, a user will be created in the dedicated bot containing the details.



In case of issues please reach out to support@engati.com