Qikberry API Docs
SMSRCS Business Messaging
SMSRCS Business Messaging
Qikberry.AI
App
  1. Messages
  • RCS Introduction
  • Messages Support
  • Messages
    • Text
      POST
    • Media
      POST
    • Text Suggestions
      POST
    • Stand Alone Card
      POST
    • Carousel Card
      POST
  • Webhooks
    • Receiving Messages via Webhook
  • Help and Support
    • Getting Help: FAQs
  1. Messages

Text Suggestions

POST
https://rest.qikberry.ai/v1/rcs/messages
Text Suggestions allow you to guide the user through a conversation by providing predefined response options. When a user taps a suggestion, that text is sent as their response — creating a more interactive, structured experience.
Suggested replies are useful for:
Menu navigation
Collecting quick responses
Confirmations (e.g., Yes/No)
Driving specific conversation flows

āœ… Supported Features#

FeatureDescription
Tap-to-sendWhen tapped, the suggestion is sent as a standard text message from the user.
Character limitTypically 20 characters per suggestion.
Multiple optionsYou can include up to 4 suggestions per message.
Quick interactionsSpeeds up user responses and reduces input errors.
No persistenceSuggestions disappear after being used or once the message is dismissed.

Suggested actions#

Agents can suggest that users to dial a number, open a location on a map, open a URL or create a calendar event.
RCS supports the following types of suggested reply & actions:
šŸ“© Suggested Replies
Suggested replies guide users through conversations by providing responses that your agent knows how to react to.
Example: "Yes", "No", "Tell me more"
šŸ“ž Suggested Actions – Dial a number
The Dial action guides the user to dial a phone number specified by your agent. Phone numbers can only include digits (0-9), plus sign (+), asterisk (*) and number sign (#). The E.164 international format (for example, +14155555555) is supported.
Example: "Call Support" → Dials +919801234567
šŸ“ Suggested Action – View Location
The View location action displays a location in the user's default map app.
Example: "View location"
šŸ“ Suggested Action – Share a Location
The Share Location action allows the user to share a location with your agent.
Example: "Share a location"
šŸ”— Suggested Actions – Open a URL
The Open URL action lets you guide users to a web page specified by your agent. By default, the web page opens in the user's browser.
Example: "Visit Website" → Opens https://example.com
šŸ”— Suggested Actions – Open a URL with webview
The Open URL with webview action loads the specified web page inside the messaging app with the rendering engine of your default browser. This allows the user to interact with the web page without leaving the RBM conversation. If the user's device doesn't support webviews, the web page opens in the user's browser instead.icon.
Example: "Visit Website" → Opens https://example.com
šŸ“… Suggested Action – Create a calendar event
The Create calendar event action opens the user's calendar app and begins to create a new event with the specified information.
Example: "Add to Calendar"
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://rest.qikberry.ai/v1/rcs/messages' \
--header 'Authorization: Bearer <ACCESS_TOKEN>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "to": "<MOBILE>",
    "agentID": "<AGENT_ID>",
    "message": {
        "templateId": "<TEMPLATE_ID>"
    }
}'
Response Response Example
200 - Success
{
    "message": "1 numbers accepted",
    "data": [
        {
            "messageId": "a8XXXXXX-1bXX-4XXd-b5XX-5dXXXXXX:1",
            "mobile": "+9198XXXXXXXXX",
            "charges": 0.05
        }
    ]
}

Request

Header Params
Authorization
stringĀ 
required
Example:
Bearer <ACCESS_TOKEN>
Content-Type
stringĀ 
required
Example:
application/json
Body Params application/json
to
stringĀ 
required
agentID
stringĀ 
required
message
objectĀ 
required
templateId
stringĀ 
required
Examples

Responses

🟢200Success
application/json
Body
message
stringĀ 
required
data
arrayĀ [object {3}]Ā 
required
messageId
stringĀ 
optional
mobile
stringĀ 
optional
charges
numberĀ 
optional
🟠400Bad Request
🟠401Unauthorized
Previous
Media
Next
Stand Alone Card
Built with