Sequence Section Webhook Block FAQs

Basics & Overview

1. What is the Sequence Section Webhook block in a chatbot used for?

The webhook block allows your chatbot to receive real-time data from an external service or application. This is essential for triggering a bot's actions based on events that happen outside of the chat.

2. In the Webhook block, what is the difference between a "Conversational" and a "Workflow" webhook type?

You can select how the data is handled in the "Select Webhook Type" field. A Conversational webhook is used when the data will be used for a direct reply to the user. A Workflow webhook is used for automation tasks that don't require an immediate reply to the user.

3. What is the purpose of the auto-generated Webhook URL for the Sequence Section Webhook block?

The Webhook URL is a unique and secure web address where your external service will send data to trigger your bot. The URL is automatically generated for you.

4. Why is an "Authorization Token" included with the Sequence Section Webhook block?

The Authorization Token is an auto-generated security key that ensures only authorized external systems can send data to your webhook. It protects your bot from unwanted requests.

Connecting to Channels

5. Why do I need to connect a bot to a channel for the Sequence Section Webhook block to work?

Webhook functionality requires the bot to be connected to at least one account because the webhook needs a way to send a reply or perform an action on a specific channel (like WhatsApp or Livechat) if needed.

6. What happens if I haven't connected my bot to a channel for the Webhook block?

If the bot is not connected to a channel, an alert will be displayed directing you to the Channels page to set up an account and link it to the bot.

7. How do I select the right channel and account for a Webhook block?

You select the channel in the "Select Channel" field, which lists all channels with active bot integration. Then, you choose the specific account linked to that channel in the "Select Account" field to ensure accurate delivery.

Mapping & Using Data

8. How do I get data from a webhook into my chatbot using the Webhook block?

You can use the "Save in variables" section to map the incoming data from the webhook to variables in your bot.

9. Using the Webhook block, how do I tell the bot what data to save from a webhook?

In the "Data" field, you specify the identifier for the data you want to capture (e.g., data.name), and in the "Set Variable" field, you choose a variable to store it in (e.g., customer_name).

10. What is the "Contact Reference ID" and why is it important for webhooks?

The "Contact Reference ID" is a unique identifier used to reach the user. For WhatsApp, it's the mobile number with the country code. For other channels, you can use the contact ID or a system variable like {sys_contact_reference_id}.

11. In the Webhook block, what is the purpose of the "Data" and "Set Variable" fields working together?

They work together to create a mapping. The Data field identifies the incoming information from the external service, and the Set Variable field tells the bot what to name that information so it can be used in the conversation.

Testing & Development

12. How can I test my Webhook block before it goes live?

The block provides a "Sample Curl Request" for both "production" and "development" environments that you can copy and use to test your webhook.

13. What is the difference between the "Production" and "Development" cURL requests for the Webhook block?

The Production cURL request provides the basic, live configuration. The Development cURL request is pre-filled with specific channel and account aliases, making it easy to test the webhook in a non-live environment without affecting your live bot.

14. What does the Authorization: Bearer header in a cURL request for a Webhook block mean?

This header is part of the request's security. It's how you send the auto-generated Authorization Token to authenticate with your webhook endpoint.

15. What does the Content-type: application/json header in a cURL request for a Webhook block mean?

This header tells the webhook that the data being sent in the request body is in a JSON format.

Step-by-Step Process

16. What is the final step to configure the Sequence Section Webhook block?

After you have filled in all the necessary fields and set up your data mapping, you must click submit to save the block.

17. How do I connect my external service to a Webhook block?

To connect your external service, you will need to copy the Webhook URL and the Authorization Token from the block and use them in your external application's settings.

Location & Tutorials

18. Where can I find the Sequence Section Webhook block in the chatbot builder?

You can find the webhook block by navigating to Dashboard → Quick Access. Then, under ChatMaxima Studio, click on Create Chatbot. The webhook block will be available in the sequence section of the builder.

19. Where can I find a video tutorial for the Sequence Section Webhook block?

To find a video tutorial for the webhook block, navigate to Dashboard → Resources. In the dropdown menu, click on Video Tutorial, and then use the search bar to find the specific guide.
Link:   https://chatmaxima.com/video-tutorials/using-sequence-webhook-in-chatmaxima/

Advanced Questions

20. What are some examples of what I can do with the Sequence Section Webhook block?

You can use a webhook to:

• Trigger a welcome message when a user signs up on your website.

• Send an alert to a bot when an order is received.

• Initiate a chat with a user when they abandon their cart.