Skip to main content
Use suggestions in POST /send-rcs to add interactive chips to an RCS message.

​
Common fields

Every suggestion object includes these fields:
FieldTypeRequiredDescription
typestringYesSuggestion type
textstringYesLabel shown on the chip
postbackstringYesValue sent back when the user taps the chip

​
Types

FieldTypeRequired
typestringYes, must be reply
textstringYes
postbackstringYes
{
  "type": "reply",
  "text": "Yes",
  "postback": "yes"
}
FieldTypeRequired
typestringYes, must be url
textstringYes
postbackstringYes
urlstringYes
{
  "type": "url",
  "text": "Open link",
  "postback": "open_link",
  "url": "https://example.com"
}
FieldTypeRequired
typestringYes, must be dialer
textstringYes
postbackstringYes
phonestringYes
{
  "type": "dialer",
  "text": "Call",
  "postback": "call",
  "phone": "0802222222"
}
FieldTypeRequired
typestringYes, must be location_latlng
textstringYes
postbackstringYes
latstringYes
lngstringYes
labelstringYes
{
  "type": "location_latlng",
  "text": "View location",
  "postback": "location",
  "lat": "6.5244",
  "lng": "3.3792",
  "label": "Sling HQ"
}
FieldTypeRequired
typestringYes, must be location_query
textstringYes
postbackstringYes
querystringYes
{
  "type": "location_query",
  "text": "Find us",
  "postback": "location",
  "query": "Sling Lagos Nigeria"
}
FieldTypeRequired
typestringYes, must be share_location
textstringYes
postbackstringYes
{
  "type": "share_location",
  "text": "Send location",
  "postback": "send_location"
}
FieldTypeRequired
typestringYes, must be calendar_event
textstringYes
postbackstringYes
datetimestringYes
titlestringYes
descriptionstringYes
{
  "type": "calendar_event",
  "text": "Save date",
  "postback": "save_date",
  "datetime": "2025-05-27T01:02",
  "title": "Sling Meeting",
  "description": "Meeting details"
}