We are sunsetting On-Premises API. Refer to our On-Premises API Sunset document for details, and to learn how to migrate to our next-generation Cloud API.

Receive Responses From Customers

After receiving Multi or Single product messages, users can: ask for more information about a product, add products to a shopping cart, and place an order. The best way to track a customer’s response to a message is by checking the webhooks alerts received for a specific message.

After sending a message, you get a message status notification webhook mentioning the status of that message. A sample webhook for a message that has been sent successfully looks like this:

{
  "statuses":[{
    "id": "message-ID",
    "recipient_id": "16315555555",
    "status": "sent",
    "timestamp": "1518694700"
  }]
}

Save that message ID to track how customers are receiving that message.

Asking For Information

Whenever a customer receives a Multi or Single Product Message, they can ask for more information about that specific product. There are two ways customers can use to ask for information:

  • Text message: In this case, the customer sends a text message asking for more information after receiving a product.
  • Clicking on "Message Business": In this case, the customer goes to a product’s Product Detail Page (PDP) and clicks on the “Message Business” button.

Once the customer sends a question, the business gets an inbound message webhook notification. These notifications include a messages object with the following components:

ComponentDescription

type

For this use case, type will be set to text.

text

The question and/or comments raised by the customer.

context

Information about the product being mentioned by the customer. You can see a product’s unique identifier as well as their catalog ID.

Use the webhook information to respond to the customer’s query. See Customer Asking For Information About a Specific Product Message for a webhooks example.

Placing an Order

Once customers have added a product to their shopping cart, they can send that cart to the business to complete the order. A business knows they have received an order by keeping up with their webhook notifications.

These notifications are of the order type and they include a messages object with the following components:

ComponentDescription

type

For this use case, type will be set to order.

order

Information about the products added to the customer’s shopping cart. The order object contains the catalog ID and an array called product_item, inside which you can find the list of products added to cart.

Use the webhook information to prepare the customer's order. See Customer placed an order after receiving a Multi or Single Product Message for a webhooks example.