Why use Webhooks?
When an event occurs in RepairPlugin, such as the creation or cancellation of an appointment, the webhook immediately sends the relevant data to your chosen application (like Zapier, Pabbly, or Make). This ensures that your connected systems are always up-to-date without any delay.
Understanding Triggers and Actions
When setting up workflows with platforms like Pabbly, Zapier, or Make, it’s essential to understand the two main components: triggers and actions.
Trigger: This is the event that initiates the workflow. For example, when a customer books an appointment in RepairPlugin, it acts as a trigger to start the automation process. The trigger determines when the workflow begins.
Action: After the trigger, the system performs an action or series of actions, such as sending a confirmation email or updating a CRM. This defines what the workflow does in response to the trigger.
By combining triggers and actions, these workflows can automate repetitive tasks, ensuring your systems stay in sync and enhancing operational efficiency.
Practical Examples of Webhook Use Cases
Customer Notifications: Automatically send an SMS or WhatsApp to customers when their appointment is scheduled, updated, or cancelled.
CRM Integration: Add or update customer details in your CRM system every time a new appointment is created or an existing one is modified.
Accounting and Billing: Send transaction details to your accounting software to automatically generate invoices or update financial records.
Available Triggers in RepairPlugin
Scheduled Appointment Created
Scheduled Appointment Updated
Scheduled Appointment Cancelled
Scheduled Appointment Deleted
Quote Created
Quote Updated
Quote Cancelled
Quote Deleted
Understanding the Payload
When RepairPlugin triggers a webhook, it sends a payload containing detailed information about the event. Here’s an example of what the payload looks like:
{
"action": "created",
"event_start_datetime": "2024-08-06T10:00",
"event_end_datetime": "2024-08-06T10:30",
"service_method": "Come by our store",
"payment_method": "Paypal",
"payment_status": "Paid",
"appointment_date": "08-06-2024",
"appointment_time": "10:00 AM",
"appointment_number": "230810041",
"appointment_status": "Pending",
"created_date": "08-05-2024",
"created_time": "04:34",
"customer_name": "John Doe",
"customer_email": "[email protected]",
"customer_phone": "1234567890",
"customer_house_no": "",
"customer_street_address": "",
"customer_city": "",
"customer_zipcode": "",
"customer_notes": "This is a test appointment",
"category": "Smartphone",
"brand": "Apple",
"model": "iPhone 11 Pro Max",
"color": "Space Gray",
"shop_name": "Repair Shop",
"location_name": "Shop 1",
"location_telephone": "1234567890",
"location_address": "123 Main St",
"location_zipcode_city": "New York, NY 10001",
"reschedule_link": "This will be available in original payload",
"cancel_link": "This will be available in original payload",
"items": [
{
"name": "LCD Display",
"type": "repair",
"price": 30
},
{
"name": "Screen - Official",
"type": "repair",
"price": 0
},
{
"name": "Wireless Charging Port",
"type": "repair",
"price": 50
},
{
"name": "Mobile Safety Glass US",
"type": "upsale",
"price": 19.95
}
],
"service_method_cost": 20,
"sub_total": 119.95,
"combo_discount": 10,
"coupon_code": "20OFFNOW",
"coupon_type": "fixed",
"coupon_amount": 20,
"tax_percentage": 21,
"excluding_tax_price": 74.34,
"tax_price": 15.61,
"total_price": 89.95
}
Key Components of the Payload
Action: Indicates the type of event (e.g., created, updated).
Event Dates and Times:
event_start_datetime
,event_end_datetime
,appointment_date
,appointment_time
provide details about the timing of the appointment.Service and Payment Information:
service_method
,payment_method
,payment_status
show how the appointment will be fulfilled and paid for.Appointment Details:
appointment_number
,appointment_status
provide specifics about the appointment.Customer Information:
customer_name
,customer_email
,customer_phone
,customer_notes
contain the customer's details.Location Details:
shop_name
,location_name
,location_telephone
,location_address
,location_zipcode_city
give information about where the appointment is taking place.Items: An array of items involved in the appointment, including their
name
,type
, andprice
.Financials:
service_method_cost
,sub_total
,combo_discount
,coupon_code
,coupon_type
,coupon_amount
,tax_percentage
,excluding_tax_price
,tax_price
,total_price
show the financial breakdown of the appointment.
Connecting RepairPlugin Webhooks to Pabbly
Log into RepairPlugin:
Access your RepairPlugin dashboard using your credentials.
Navigate to Webhooks Section:
Go to
Settings
>Integrations
>Webhooks
.
Create a New Webhook:
Click on
Add Webhook
.Select the appropriate event from the list of triggers (e.g.,
Scheduled Appointment Created
).Enter the webhook URL provided by Pabbly.
Log into Pabbly:
Open Pabbly Connect and log in to your account.
Create a New Workflow:
Click on
Create Workflow
.Name your workflow and click
Create
.
Set Up the Trigger:
Choose
Webhook
as the trigger.Copy the webhook URL provided by Pabbly.
Paste Webhook URL into RepairPlugin:
Go back to the RepairPlugin webhook settings.
Paste the Pabbly webhook URL into the designated field.
Click
Save
.
Test the Connection:
Trigger the selected event in RepairPlugin.
Check Pabbly to ensure the data is received correctly.
Connecting RepairPlugin Webhooks to Zapier
Log into RepairPlugin:
Access your RepairPlugin dashboard using your credentials.
Navigate to Webhooks Section:
Go to
Settings
>Integrations
>Webhooks
.
Create a New Webhook:
Click on
Add Webhook
.Select the appropriate event from the list of triggers (e.g.,
Pdf Offer Created
).Enter the webhook URL provided by Zapier.
Log into Zapier:
Open Zapier and log in to your account.
Create a New Zap:
Click on
Make a Zap
.
Set Up the Trigger:
Search for
Webhook
and selectCatch Hook
.Click
Continue
and copy the custom webhook URL provided by Zapier.
Paste Webhook URL into RepairPlugin:
Go back to the RepairPlugin webhook settings.
Paste the Zapier webhook URL into the designated field.
Click
Save
.
Test the Connection:
Trigger the selected event in RepairPlugin.
Check Zapier to ensure the data is received correctly.
Connecting RepairPlugin Webhooks to Make
Log into RepairPlugin:
Access your RepairPlugin dashboard using your credentials.
Navigate to Webhooks Section:
Go to
Settings
>Integrations
>Webhooks
.
Create a New Webhook:
Click on
Add Webhook
.Select the appropriate event from the list of triggers (e.g.,
Ship Device Appointment Updated
).Enter the webhook URL provided by Make.
Log into Make (formerly Integromat):
Open Make and log in to your account.
Create a New Scenario:
Click on
Create a new scenario
.
Set Up the Trigger:
Search for
Webhook
and selectCustom webhook
.Click
Add
to create a new webhook and copy the provided URL.
Paste Webhook URL into RepairPlugin:
Go back to the RepairPlugin webhook settings.
Paste the Make webhook URL into the designated field.
Click
Save
.
Test the Connection:
Trigger the selected event in RepairPlugin.
Check Make to ensure the data is received correctly.
Routing Actions Based on Service Method
One practical use of webhooks is to route actions based on specific items in the payload, such as the service method. Here’s how you can set up routing in Pabbly, Zapier, and Make:
Service Methods in RepairPlugin
Come by our store
Ship device
Pickup service
Repair on your location
Routing in Zapier
Create a New Zap:
Open Zapier and click on
Make a Zap
.
Set Up the Trigger:
Select
Webhook
and chooseCatch Hook
.Copy the webhook URL and paste it into RepairPlugin's webhook settings.
Filter by Service Method:
Add a
Filter
step after the trigger.Set up a condition to check the
service_method
field.Create separate filters for each service method.
Set Up Actions for Each Service Method:
For
Come by our store
: Send an email/SMS confirmation to the customer.For
Ship device
: Create a shipping label and send instructions.For
Pickup service
: Schedule a pickup with your logistics provider.For
Repair on your location
: Notify your field technician team and schedule the visit.
Routing in Pabbly
Create a New Workflow:
Open Pabbly Connect and click on
Create Workflow
.
Set Up the Trigger:
Choose
Webhook
and copy the webhook URL.Paste it into RepairPlugin's webhook settings.
Use Router for Service Method:
Add a
Router
step in Pabbly.Create routes based on the
service_method
field.
Set Up Actions for Each Route:
For
Come by our store
: Send an email/SMS confirmation to the customer.For
Ship device
: Create a shipping label and send instructions.For
Pickup service
: Schedule a pickup with your logistics provider.For
Repair on your location
: Notify your field technician team and schedule the visit.
Routing in Make
Create a New Scenario:
Open Make and click on
Create a new scenario
.
Set Up the Trigger:
Select
Webhook
and chooseCustom webhook
.Copy the webhook URL and paste it into RepairPlugin's webhook settings.
Use Router for Service Method:
Add a
Router
While this guide provides a comprehensive overview of setting up these integrations, it's important to note that RepairPlugin does not offer support for integrating your systems.