Configure Receive Message

Configure to receive SMS, auto-reply, forward, trigger URL with a VMN and keyword.

Configure to receive messages

You need to configure a VMN(Recipient Number) to receive SMS from the end-customers/prospects.

To configure the to receive SMS, perform the following steps:

  1. Sign in to your Kaleyra.io account.
  2. Go to Channels > SMS option.
  3. Click Manage.
    The SMS channel menu bar appears.
  4. Click on Receive Messages.
    The list of Receive SMS Configurations and Logs appears.

  1. To configure a new Receive Message, click + New Configuration.

  1. In the Select SMS Recipient section, enter the recipient VMN details in the following fields.
    1. Select Recipient Number—Select a recipient number. This is the VMN configured to receive the SMS sent by your customers. This field is mandatory.
    2. Keyword—Enter a keyword that you share with the customers to receive messages for an appropriate action. This field is mandatory.
      The customers must use this keyword along with their message in order to send the message successfully.
    3. Keyword Expiry—Select a date on which the keyword expires. This field is mandatory.
      When a keyword expires, the incoming messages with that keyword will not be processed.

📘

Note:

The Recipient Number and the Keyword fields are mandatory for you to create a new configuration. You can use the Edit Configuration option in the Configurations section to add in the other configuration details later.

  1. 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.

  1. Auto Reply—You can configure to 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 to be sent later.

    1. Sender ID—Select a sender ID using which you want to send the response back to the customer.
    2. Enter your text message here—Type the text that you want to send as a response to the customer. This field is mandatory.
    3. SMS Route—Select the SMS route using which the message should be sent to the customer.
    4. Template ID—Depending on the country from where your customer is, the template ID field is mandatory (when the Auto Reply option is selected).
      For example, to send the message to a customer in India, you must select a template ID.
    5. Autoreply on Expiry—Enter the message that should be sent to only those customers, who will send the SMS after the keyword has expired.
      In the Autoreply on Expiry message, you can suggest the alternate options for a continued engagement with your customers.
    6. Expiry Template ID—. Depending on the country from where your customer is, the template ID field is necessary. For example, to send the message to a customer in India, you must select a template ID.
      Note: You can specify two different SMS text and Template IDs or the same SMS Text and Template ID for the Auto Reply and the Autoreply on Expiry messages.
    7. 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.
  2. Forward—You can configure to forward the received SMS to another phone number along with the customer's phone number.

    1. Sender ID—Select the sender ID using which the reply SMS should be sent back to the customer.
    2. SMS Route—Select the SMS route based on the type of business transaction with the customer.
    3. 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.
    4. Email Forward—Enter the email ID to which the SMS should be delivered for further action.Trigger URL—Specify the webhook URL using which you can track the messages received from the customers or the responses sent to the customers.
  3. 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.

    1. Trigger URL—Specify the trigger URL for the GET method.
      The URL must be in the format specified below this field. The URL must contain the mobile number and the message.
    2. Request Body—Enter the request body for the POST method that includes the message and the mobile number of the customer.
    3. Request Type—Specify the request type for the content. ‘application/json’ request type is supported.
  4. Callback ID—Select this option, if you already have a callback profile created.

    For more information on how to create callback profiles, see:
    Callback Profiles.
    *Select Callback Profile**—Select a callback ID from the list.

  5. Select Opt-in settings toggle button to configure the VMN with the specified keyword for opt-in service.

  6. Select Opt-out settings toggle button to configure the VMN with the specified keyword for opt-out service.

📘

Note:

  1. The Reply Type scheduling applies only when the keyword is valid.
  2. The forwarded SMS messages are listed on the Channels > SMS > Analytics page.
  3. Based on the keyword and the actions that you have defined on the configuration page for a VMN, the end-customers receive the corresponding opt-in or opt-out services.