You need to configure a dedicated long code or short code to receive incoming SMS from end-users.
To configure a number for the Receive Message feature, perform the following steps:
- Sign in to your Kaleyra.io account.
- Go to Channels > SMS option.
- Click Manage.
The SMS channel menu bar appears.
- Click on Receive Messages.
The list of Receive SMS Configurations appears.
- To configure a new Receive Message, click + New Configuration.
- From the Select Recipient Number drop-down, if you are selecting a shared short code, then the Default Configuration option gets disabled.
- The shared short code can be configured for multiple unrelated business organizations but the keyword associated with shared short code can not be shared by multiple accounts.
- In the Select SMS Recipient section, enter the recipient VMN details in the following fields.
- Select Recipient Number—Select a recipient number. This is the VMN configured to receive the SMS sent by your customers. This field is mandatory.
- Keyword—Enter a keyword that you share with the customers to receive messages for an appropriate action.
This field is mandatory for configurations other than the default configuration.
When the default configuration is not set, you must use this keyword along with your message to send the message successfully. In the case of shared short code, the system will check that the keyword is not already in use for the same shared SC by another organization and that if so, an error will be thrown.
- Keyword Expiry—Select a date on which the keyword expires.
This field is mandatory, for configurations other than the default configuration.
When a keyword expires, the incoming messages with that keyword are not processed.
You can use the Edit Configuration option in the Configurations section to add in the other details later.
- In the Configuration section, enter the Receive SMS configuration details in the following fields. You can use one or more options in this section to take the appropriate actions based on your customers' preferences that are determined by the keywords.
- Auto Reply—You can send an auto reply message to a customer whenever a message that has the matching keyword is received from the customer. You can either send the auto reply as soon as you receive a message or schedule it to be sent later.
- Sender ID—Select a sender ID using which you want to send the response back to the customer.
- Enter your text message here—Type the text that you want to send as a response to the customer. This field is mandatory.
- SMS Route—Select the SMS route using which the message should be sent to the customer.
- Template ID—Based on the region/country in which the account registration is made, the template ID field is mandatory (when the Auto Reply option is selected).
For example, to send a message to a customer in India, you must select a template ID.
- Reply Type
Instant Reply—Select this option, if you want to send an auto reply message immediately after receiving a message.
Scheduled Reply—Select this option, if the reply message should be sent at a later date and time. Using the calendar icon, first select the date and the time to send the auto reply message.
- Forward—You can configure to forward the received SMS to another phone number along with the customer's phone number details.
- Sender ID—Select the sender ID using which the incoming SMS should be forwarded.
- SMS Route—Select the SMS route based on the type of business transaction with the customer.
- Template ID—This field appears only when you select a phone number from India to forward the message. This field is mandatory.
For customers from other countries than India, the Template ID field does not appear. A template that matches the message text will be used for sending the message.
- Email Forward—Enter the email ID to which the SMS should be delivered for further action.
- Trigger URL— Select this option, if you want to use a trigger URL (webhook URL) to track the messages received and the responses sent back to the customer.
- You can configure the trigger URL (webhook) or a callback profile ID to receive notifications for all the mobile originated (MO) messages or by the specific keywords.
- For keywords specific to the MOs, create new configurations that include the keyword and the webhook URL as described in the following Trigger URL steps.
- For all the MOs, create a default configuration (without the keyword) and the webhook URL as described in the trigger URL section.
- Trigger URL—Specify the trigger URL for the GET method.
- The URL must be in the format:
The URL must contain the mobile number and the message.
- Request Body—Enter the request body for the POST method that includes the message and the mobile number of the customer.
- Request Type—Specify the request type for the content. ‘application/json’ request type is supported.
- The URL must be in the format:
Callback ID—Select this option, if you already have a callback profile created.
Make sure to refer to a callback ID created for the POST method to capture the MO message body.
For more information on how to create callback profiles, see Callback Profiles
- Select Opt-in settings toggle button to set the VMN with the specified keyword as an opt-in configuration.
An end-customer who has opted in will receive all the messages from the VMN.
- Select Opt-out settings toggle button to set the VMN with the specified keyword as an opt-out configuration.
An end-customer who has opted-out will not receive any further messages from the VMN.
You can only select one of these toggle options in a single configuration.
- The Reply Type scheduling applies only when the keyword is valid.
- The forwarded SMS messages are listed on the Channels > SMS > Analytics page.
- Based on the keyword and the actions that you have defined on the configuration page for a VMN, the end user receive the corresponding opt-in or opt-out services.
Updated 4 days ago