Inbound Triggers
The following guide will assist you in setting up inbound triggers
Last updated
The following guide will assist you in setting up inbound triggers
Last updated
When a user sends a reply to an SMS or a keyword to a shortcode, specific triggers can be set up to take action. The system can automatically send an autoreply and forward the inbound message to an email address or another server.
After logging into your account, navigate to the left pane and click on Triggers. This will direct you to the triggers management screen.
To set up a new trigger, click on New Trigger. You will be prompted to name your trigger. A meaningful name helps in identifying the trigger's purpose at a glance.
On the Trigger settings page, you will find several options to customize your trigger according to your needs. These settings include:
Name: Assign a name to your trigger. Choose a name that reflects the purpose of the trigger for easy identification.
Active: Ensure the Active checkbox is selected to enable the trigger.
Conditions
Define the conditions that must be met for the trigger to activate. You can specify if all conditions must be met or if meeting any one condition is sufficient. For instance, you may set conditions such that only messages fulfilling all specified criteria will initiate the trigger actions.
Actions
After defining your conditions, select the actions to be performed when those conditions are met. The available actions include:
Send SMS: Automatically sends a response SMS to the sender.
Send Email: Use macros to personalize email content, including the #MESSAGE#
macro to incorporate the SMS message into the email. Please refer to a list of all available macros further on in this guide. There is also a checkbox to enable HTML mail if you wish to paste HTML code in for the mailer.
Call URL: Forward the message to another web service. This action pushes the message to a specified URL using a GET method, appending all message variables to the URL for easy retrieval and handling by your script.
Add to List: Add the mobile number to a saved contact list.
Remove from List: Removes the number from a saved contact list.
Macros are a powerful feature that allows you to include dynamic content in your actions. For instance, inserting the #MESSAGE#
macro in an email action will automatically fill in the content of the inbound SMS message.
Any trigger you create can be edited at any time. To edit a trigger, navigate to the Triggers section, select the trigger you wish to modify, and make the necessary adjustments. This ensures that your automated responses and forwarding rules can evolve with your communication needs.
Test Your Triggers: Before fully implementing a new trigger, test it to ensure it behaves as expected. This might involve sending messages that meet the trigger's conditions to verify the actions are executed correctly.
Macro | Description |
---|---|
#MESSAGE#
Original message content
#MOBILENUMBER#
or #FROM#
Number the message was sent from
#FROMWITHOUTPLUS#
Number the message was sent from (without the +)
#INBOUNDNUMBER#
or #TO#
Number the message was sent to
#DATE#
Date of the message
#ACCOUNTID#
The user account id
#ACCOUNTUSERNAME#
Your account username
#ACCOUNTEMAIL#
The email address of the user
#ACCOUNTMOBILE#
The mobile number of the user
#MESSAGEID#
Original outbount message ID (if available)
#CLIENTREFERENCE#
Client reference specified during message send (if available)