Skip to main content
RCS is a messaging protocol that offers rich chat features like video, images, and other interactive elements. The API reference can be found here.

​
Sending an RCS Message

Here’s an example of how to send an RCS message. Request - 
curl -X POST -H 'Authorization: Bearer ***' https://api.telnyx.com/v2/messages/rcs \
  -H 'Content-Type: application/json' \
  -d'{
       "agent_id": "Agent007",
       "to": "+13125551234", 
       "messaging_profile_id": "8c7970de-8fde-46ea-a1ff-1ad2f242b99a",
       "agent_message": {
         "content_message": {
           "rich_card": {
             "standalone_card": {
               "card_orientation": "VERTICAL", 
               "thumbnail_image_alignment": "LEFT", 
               "card_content": {
                 "media": {
                   "height": "MEDIUM", 
                   "content_info": {"file_url": "https://example.com/elephant.jpg"}
                 }
               }
             }
           }
         }
       }
     }'
Response - 
{
  "data": {
    "record_type": "message",
    "direction": "outbound",
    "id": "40319397-d1cb-4343-9e6e-168d2f8bce64",
    "type": "RCS",
    "organization_id": "dd8f893d-ca1b-4fb0-b092-3af875e90a22",
    "messaging_profile_id": "8c7970de-8fde-46ea-a1ff-1ad2f242b99a",
    "from": {
      "agent_id": "Agent007",
      "carrier": "Telnyx",
      "agent_name": "Test Agent"
    },
    "to": [
      {
        "phone_number": "+13125551234",
        "status": "queued",
        "carrier": "CELLCO PARTNERSHIP DBA VERIZON WIRELESS - IL",
        "line_type": "Wireless"
      }
    ],
    "body": {
      "content_message": {
        "rich_card": {
          "standalone_card": {
            "card_orientation": "VERTICAL",
            "thumbnail_image_alignment": "LEFT",
            "card_content": {
              "media": {
                "height": "MEDIUM",
                "content_info": {
                  "file_url": "https://example.com/elephant.jpg"
                }
              }
            }
          }
        }
      }
    },
    "encoding": "utf-8",
    "parts": 1,
    "tags": [],
    "cost": {
      "amount": null,
      "currency": null
    },
    "received_at": "2024-12-05T17:15:28.961+00:00",
    "sent_at": null,
    "completed_at": null,
    "valid_until": "2024-12-05T18:15:28.961+00:00",
    "cost_breakdown": null
  }
}