Configure Receive Message
Configure to receive SMS, auto-reply, forward, and trigger URL with a VMN and keyword.
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 and on the SMS card click Manage.
Notes:
- 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 cannot be shared by multiple accounts.
- In the Select SMS Recipient section, enter the recipient VMN details in the following fields.
Select the SMS option to view the SMS Details section.
The Email Details section has the following field:
Select SMS and Email option to forward the received message both to a mobile number via SMS and to an email address of your choice.
- The URL must be in the format:
Example:<http://website.com/api.php?mobile={mob}&message={message}>
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.

OR
Callback ID—Select this option, if you already have a callback profile created.

Note:
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 Subscribe toggle button to set the VMN with the specified keyword as subscribe configuration. A recipient will still receive messages if that number is utilized in a campaign even if it is not subscribed or unsubscribed. You only need to provide the brand with the option to collect explicit subscription or unsubscription, but it is up to the brand to use this information.
- Select Unsubscribe toggle button to set the VMN with the specified keyword as unsubscribe configuration. The Unsubscribed end-user will not receive any more messages from either the specified sender ID or from all sender ID according to your configuration.
- Click Save to save the settings once you make any changes.

You can select one of the Configured Sender ID or All Sender IDs toggle options in a single configuration.
Note:
- 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, it is up to the brand to use this information to provide or not to provide the service.
Updated 10 days ago