Zoho FSM | Webhooks

Webhooks

Webhooks offer a way for you to establish communication between Zoho FSM and another application when an event occurs and exchange information about the event that occurred. A webhook is an event-notification via a HTTP URL. To trigger a webhook, you need to use it in conjunction with workflow rules.
 
- Permission Required: Manage Automation
- Find out the Edition-specific limits for Webhooks.

Create Webhooks

To create a webhook:
  1. Navigate to Setup > Automation > Webhooks and click Create Webhook.
  2. In the Create WebHook overlay, enter the following details and click Save.

    Field Name

    Action Required

    Name

    Enter a name for the webhook

    Description

    Provide details about the webhook

    Method

    The HTTP method that you want to use for the webhook. You can choose from GET (Retrieve), POST (Create), PUT (Update), and DELETE (Remove) methods.

    URL to Notify

    Specify the REST API URL from the application to which you want to send information.

    Authorization Type

    Choose an authorization method:

    • General (includes API Key or AUTH Token)

    • Connection

     

    You can either use an existing connection or new a new one. Click New Connection to create a new one. Once created, click on the Refresh icon [] to see the newly created connection listed.

    Module

    Select a module whose information you want to use in the webhook. The supported modules are:

    • Assets

    • Companies

    • Contacts

    • Estimates

    • Requests

    • Service Appointments

    • Services And Parts

    • Work Orders

    Headers

    Add any detail, if required that will convey some information about the request. Use module parameters to send dynamic values, and custom parameters for static values like authentication information.

    • Module Parameters: Click Add New Line and provide the Parameter Name, Parameter type, and Parameter Value.

    • Custom Parameters: Click Add New Line and provide the Parameter Name and Value.

    Body

    Add the information you want to pass through the Webhook URL. You can choose the format in which you want to pass the information. Either choose the Type as Form-Data or Raw.

    • Form-Data: Using this you can send key-value pairs. You can send these using the Module Parameters, Custom Parameters, and User defined Parameters. Use Module Parameters, and User defined Parameters to send dynamic values. Use Custom Parameters for static values.

      • Module Parameters: Click Add New Line and provide the Parameter Name, Parameter type, and Parameter Value.

      • Custom Parameters: Click Add New Line and provide the Parameter Name and Value.

      • User defined Parameters: Click Add New Line and provide the Parameter Name and Value. Use # or click Insert to add a placeholder. The placeholders will get replaced with actual values when the webhook is triggered.

    • Raw: Using this you can input data in the formats: XML, JSON, HTML, or TEXT. Use # to add a placeholder. The placeholders will get replaced with actual values when the webhook is triggered.

    Preview URL

    You can view the preview of the webhook URL constructed. Preview URL displays the complete webhook URL for GET and DELETE request method, while for the POST and PUT method, only the configured URL is displayed. Click on the Refresh icon [] to see the latest changes.

Associate with Workflow Rules     

You can either associate an existing webhook with the workflow or create a new webhook and associate it to the workflow.
 

Manage Webhooks   

You can edit or delete the webhooks.
 

Example

When an asset is added to Zoho FSM, send an SMS to the contact with the warranty details. To implement this, follow the steps below:
  1. Create a webhook to send a SMS via Twilio.
  2. Create a workflow rule for triggering the webhook when a new Asset record is created.

Create a webhook

  1. Navigate to Setup > Automation > Webhooks and click Create Webhook.
  2. Perform the following, then click Save:
    1. Name: WarrantyDetails
    2. A suitable Description
    3. Method: POST
    4. URL to Notify: https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json
      Replace {AccountSid} with the actual value. Refer Twilio's API documentation for details.
    5. Authorization Type: Connection
    6. In the Choose Connection field, click New Connection. Select the newly created connection.
    7. Module: Assets



    8. Under Body, do the following:
      1. Type: Form-Data
      2. Click Add New Line for Module Parameters and enter the following parameter values:
        Parameter Name: To
        Module Name: Contact
        Field Name: Mobile
      3. Click Add New Line for Custom Parameters and enter the following:
        From: Your Twilio phone number
        StatusCallback: http://postb.in/1234abcd
      4. Click Add New Line for User defined Parameters and enter the following:
        Body: Dear ${!Assets.Contact.First_Name} ${!Assets.Contact.Last_Name}, The warranty for your Asset ${!Assets.Name} is valid till ${!Assets.Warranty_Expiration}. Thanks.


Create a Twilio Connection

  1. In My Connections page, click Create Connection.



  2. Under the Default Services tab, select Twilio.



  3. Enter the Connection Name as Twilio and click Create And Connect.
    The Connection Link Name will be automatically populated.



  4. Click Connect in the authentication page.



  5. Click Authorize in the Authorization page.



  6. Enter the Account SID and Auth Token and click Authorize.

Create a workflow

  1. Go to Setup > Automation > Workflow Rules and click Create Workflow.
  2. Enter the following details, then click Next:
    1. Module: Assets
    2. Rule Name: Send Warranty Details
    3. Description: When an asset is added to Zoho FSM, send an SMS to the contact with the warranty details.



  3. Select the rule trigger as Created and click Next.



  4. Select the rule criteria as To all Assets and click Next.



  5. Click +Action and select Webhook.



  6. Select Existing Webhooks and click Next.



  7. Select the webhook created earlier and click Next.



  8. Click Save.

Note: Ensure that the mobile number of the contact is formatted with a + and country code.

      Create. Review. Publish.

      Write, edit, collaborate on, and publish documents to different content management platforms.

      Get Started Now


        Access your files securely from anywhere

          Zoho CRM Training Programs

          Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

          Zoho CRM Training
            Redefine the way you work
            with Zoho Workplace

              Zoho DataPrep Personalized Demo

              If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

              Zoho CRM Training

                Create, share, and deliver

                beautiful slides from anywhere.

                Get Started Now


                  Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                  BOOK A SESSION







                              Quick LinksWorkflow AutomationData Collection
                              Web FormsEnterpriseOnline Data Collection Tool
                              Embeddable FormsBankingBegin Data Collection
                              Interactive FormsWorkplaceData Collection App
                              CRM FormsCustomer ServiceAccessible Forms
                              Digital FormsMarketingForms for Small Business
                              HTML FormsEducationForms for Enterprise
                              Contact FormsE-commerceForms for any business
                              Lead Generation FormsHealthcareForms for Startups
                              Wordpress FormsCustomer onboardingForms for Small Business
                              No Code FormsConstructionRSVP tool for holidays
                              Free FormsTravelFeatures for Order Forms
                              Prefill FormsNon-Profit
                              Intake FormsLegalMobile App
                              Form DesignerHRMobile Forms
                              Card FormsFoodOffline Forms
                              Assign FormsPhotographyMobile Forms Features
                              Translate FormsReal EstateKiosk in Mobile Forms
                              Electronic Forms
                              Drag & drop form builder

                              Notification Emails for FormsAlternativesSecurity & Compliance
                              Holiday FormsGoogle Forms alternative GDPR
                              Form to PDFJotform alternativeHIPAA Forms
                              Email FormsEncrypted Forms

                              Secure Forms

                              WCAG

                                      Create. Review. Publish.

                                      Write, edit, collaborate on, and publish documents to different content management platforms.

                                      Get Started Now




                                                        You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                            Manage your brands on social media


                                                              • Desk Community Learning Series


                                                              • Digest


                                                              • Functions


                                                              • Meetups


                                                              • Kbase


                                                              • Resources


                                                              • Glossary


                                                              • Desk Marketplace


                                                              • MVP Corner


                                                              • Word of the Day


                                                              • Ask the Experts


                                                                Zoho Sheet Resources

                                                                 

                                                                    Zoho Forms Resources


                                                                      Secure your business
                                                                      communication with Zoho Mail


                                                                      Mail on the move with
                                                                      Zoho Mail mobile application

                                                                        Stay on top of your schedule
                                                                        at all times


                                                                        Carry your calendar with you
                                                                        Anytime, anywhere




                                                                              Zoho Sign Resources

                                                                                Sign, Paperless!

                                                                                Sign and send business documents on the go!

                                                                                Get Started Now




                                                                                        Zoho TeamInbox Resources





                                                                                                  Zoho DataPrep Demo

                                                                                                  Get a personalized demo or POC

                                                                                                  REGISTER NOW


                                                                                                    Design. Discuss. Deliver.

                                                                                                    Create visually engaging stories with Zoho Show.

                                                                                                    Get Started Now









                                                                                                                        • Related Articles

                                                                                                                        • Audit Log

                                                                                                                          The Audit log captures the activities performed within the Setup of your FSM organization. This audit log can be viewed at Setup > Data Administration > Audit Log. Click on an entry to see the details. Filters Any of the following filters can be ...
                                                                                                                        • Data Retention in Zoho FSM

                                                                                                                          Zoho FSM's data retention policy defines the storage duration for various types of data, detailing how long they are retained after deletion. Particulars of Data Deletion Scenario Retention Period In BackUp server Zoho FSM Account On customer request ...
                                                                                                                        • Workflow Rules and Actions

                                                                                                                          With field services increasingly gaining traction worldwide, they are continuously evolving into a more systematic and standardized process. Automation plays a pivotal role in this transformation. Studied automation can make all the difference ...
                                                                                                                        • Workflow Rules and Actions Using Notes

                                                                                                                          In Zoho FSM, workflow rules using notes help automate actions based on information added to records. By leveraging notes in workflow automation, teams can streamline communication, escalate issues, and automate service processes. The following are ...
                                                                                                                        • Editions and Pricing

                                                                                                                          The details of the various Zoho FSM editions and their pricing details are mentioned below. Features Edition Free Standard Professional Fixed Base Price Free 30.00 USD (billed monthly) 45.00 USD (billed monthly) 300.00 USD (billed annually) 420.00 ...
                                                                                                                          Wherever you are is as good as
                                                                                                                          your workplace

                                                                                                                            Resources

                                                                                                                            Videos

                                                                                                                            Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                            eBooks

                                                                                                                            Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                            Webinars

                                                                                                                            Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                            CRM Tips

                                                                                                                            Make the most of Zoho CRM with these useful tips.



                                                                                                                              Zoho Show Resources