Webhooks allow you to trigger automated scenarios based on events from external applications. This guide will walk you through the process of setting up and using webhooks to initiate scenarios, providing a seamless integration between Inrō and other tools you use.
Introduction to Webhooks
Webhooks enable real-time data transfer between Inrō and external applications. When an event occurs in another application, it can send a POST request to Inrō’s webhook URL, triggering the specified scenario. This feature is useful for automating responses to events such as form submissions, CRM updates, or any other action that supports webhooks.
Getting the Webhook URL
Create or Edit a Scenario: Navigate to the Scenarios & create a new scenario or edit an existing one.
Select the Webhook Trigger: In the scenario setup, choose the Webhook trigger option.
Save the Scenario: After configuring your scenario, save it. The webhook URL will be generated and displayed.
Triggering the Webhook
Here is the information you need for your app or third-party service like Zapier or Make:
URL: Follow the indications above to get your unique webhook URL after saving your scenario
Request Type:
POSTMandatory Body Parameters: You must include at least one of the following to identify the contact:
Example Body Parameters:
{ "contact_id": 65427, "username": "john_doe", "email": "[email protected]" }Example CURL Command:
curl -X POST -H "Content-Type: application/json" -d '{"contact_id":65427,"username":"john_doe","email":"[email protected]"}' <https://your-inro-webhook-url.com>
Using Webhook Variables in Actions
Any parameter included in your request’s body can be used as a variable in your scenario actions. Use the following syntax to insert these variables:
{{webhook.parameter}}Example: If your webhook request body includes:
{ "contact_id": 65427, "first_name": "John", "appointment_date": "March 24th, 2024" }You can use these variables in your messages:
Hi {{webhook.first_name}}, your appointment is confirmed for {{webhook.appointment_date}}.
Inrō Insider Tips
Test your webhooks: Always test your webhook configurations with sample data to ensure they work as expected before going live.
Use many relevant variables: Include as many relevant parameters as possible in your webhook requests to maximize personalization and context in your automated responses.
Keep data secure: Ensure that any sensitive data transmitted via webhooks is encrypted and securely handled to protect your users' privacy.
Feedback
If you have any questions or need further assistance, feel free to reach out to our support team or leave a review on this article.