Activechat Manual
  • What is Activechat?
  • New? Start here
    • The basics
    • Set up your first project
    • Install the chat widget
    • Upload the knowledge
    • Explore the CRM
    • AI-assisted live chat
      • How to set context for AI hints
    • Live chat mobile app
    • Build your first automation
  • Conversational AI
    • For Customer Service Teams
    • For Product Managers
    • For Innovation Teams
    • For Marketers
    • For e-commerce
    • For developers
  • Help Guides
    • Setting up your team
    • Managing conversations
      • Customer attributes
      • User tags and segments
      • Searching for specific users
      • Agent tags (live chat groups and queues)
      • Triggering live chat sessions from the bot
      • Notifications with the TRIGGER block
    • Managing knowledge
      • Uploading business data
      • Question answering and live chat hints
      • Fine-tuning the large language model
    • Natural language automation
    • Building automations visually
      • Customizing your welcome message
      • Adding new skills
      • Navigating skills
      • Copying skills and blocks
      • Handling errors
    • Improving your virtual agent
    • Using live chat AI hints
    • Customizing automatic website page messages
    • Tracking website actions
    • Facebook Ads automation
      • How to set up a Facebook ads bot
      • How to use buttons and quick replies in a Facebook ads chatbot
    • Lead generation
    • Zapier integrations
    • Customizing your project
      • How to customize the chat widget
      • How to customize the Facebook chat widget
      • How to change bot settings
    • Pricing guide
  • Fundamentals
    • Terminology
      • Intents and entities
      • Contexts
      • Skills and events
        • Built-in system skills
          • /start
          • /default
          • /_default_fallback
          • /_start_live_chat
          • /_page_visit
          • /_error
      • Conversation elements
        • Messages
        • Buttons
        • Quick replies
        • Galleries / carousels
    • Messaging channels
      • Website chat widget
        • Installation
        • Customization
        • Voice input
      • Chat widget landing page
      • Facebook Messenger
        • Connect your page
        • 24 hour rule
        • Message tags
        • Persistent menu
      • Telegram
      • Email
      • Twilio SMS automation
    • Intents and bot skills
    • Conversation insights
    • Grow tools
      • Landing pages
      • Messenger links and QR codes
    • Broadcasting
  • Visual builder reference
    • Sending messages
      • TEXT
      • LISTEN
      • IMAGE
      • MEDIA
      • GALLERY
      • FILE
      • EMAIL
      • SMS
      • LEAD
    • Triggering events
      • SEND
      • CATCH
      • TRIGGER
      • LIVE CHAT
    • Manipulating data
      • DATA
      • ADD TAG
      • REMOVE TAG
      • JSON
      • STATUS
      • VALIDATION
    • Conditional logic
      • SWITCH
    • Timers and delays
      • TIMER
      • WAITFOR
      • WAITUNTIL
    • E-commerce blocks
      • CATEGORY
      • PRODUCT
      • VARIATIONS
      • SIMILAR
      • UPSELLS
      • CROSSSELS
      • Shopping carts
        • ADD TO CART
        • UPDATE CART
        • SHOW CART
        • CLEAR CART
        • CREATE ORDER
    • Natural Language
      • NLP
    • System attributes
    • System events
  • Integrations
    • Google services
      • Connect your Google account
      • Google Sheets
        • Searching and updating Google Sheets data
        • Building galleries with Google Sheets data
      • Google Calendar
        • Searching for events
        • Creating and updating events
    • Shopify
    • WooCommerce
    • Dialogflow
      • Building an agent
      • Using entities
      • Slot filling
      • Context management
      • E-commerce NLP
Powered by GitBook
On this page

Was this helpful?

  1. Visual builder reference
  2. Triggering events

CATCH

PreviousSENDNextTRIGGER

Last updated 3 years ago

Was this helpful?

This block is used to “catch” specific events and trigger conversation flows that should handle that event. Every skill in your bot should start with a CATCH block so that this skill can be triggered by a specific event. If you add any parameter values to the CATCH block, on catching the event it will check event parameters and start executing connected blocks only when parameter values are the same. This is handy to process various ref= links to have different parts of the bot started with different Facebook ads, for example. If the parameter value is different from the filter, the CATCH block will not be triggered by the event even if the event name is the same.

CATCH block listens to chatbot events

Using bot commands

Every CATCH block that you add to your bot creates a specific “slash” command in the bot.

Example:

CATCH block with “hello” event name above would create “/hello” command and this command will trigger blocks that are connected to CATCH. Use this to add commands that control your bot behavior. With Activechat you can create those commands in every connected messaging channel, including Facebook and Twilio SMS.

An event-based model is very flexible and can be used to make various parts of your chatbot conversation run independently and in parallel. This is great if you need a complex bot, but can lead to conflicts and other issues.

A common issue among novice chatbot developers is using multiple CATCH blocks with the same event name. When this event is triggered, all these blocks will get control simultaneously, and multiple conversation flows will start running.

Try to avoid “schizophrenic” models that will communicate with your chatbot user in different flows at the same time. Good planning of your conversation flow and events framework is key here. We’ll get back to this topic in more detail in the “Conversational design best practices” section.

When the chatbot user is typing “/hello” in the conversation, the “hello” event will be triggered in the chatbot and the “hello” (if you have one!) will start running.

Telegram users: don’t forget to use the bot if you want to add these slash commands to the list of bot commands in Telegram so that they will be available for autocomplete when the user types “/” in your chatbot. A list of commands is available in the “Edit Bot -> Edit Commands” menu of @BotFather.

skill
@BotFather