Telnyx RCS Messaging

RCS is a messaging protocol that offers rich chat features like video, images, and other interactive elements.

The API reference can be found here.

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
  }
}