Sign in
RCS

Send an RCS message

Sends from one of your agents. Use text for a plain message or content for rich content (card, carousel, media, suggestion chips). Before launch an agent only reaches test phones that accepted the invite. With the agent's smsFallbackFrom set, phones without RCS get fallbackText (default: the message's readable text) as SMS.

Replies and status arrive as webhooks with platform: "rcs": message.received (a tapped chip carries its postback in metadata.postbackPayload), message.delivered, message.read and message.failed. Send an Idempotency-Key header to make retries safe.

post/v1/rcs/messages

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409.

Request body

agentIdstring required
tostring required

Recipient number (E.164; formatting is normalized).

textstring
fallbackTextstring
ttlSecondsinteger

Seconds before an undelivered message expires.

Response

Message accepted.

idstring

Message ID

conversationIdstring
status'sent'

Changes

Changed in 3 of the 65 revisions of this API.10

  • d556591af3f68See the full diff
    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

  • 16a7b9d5373e1See the full diff
    • ○

      removed the platform enum value from the / response property for the response status

      response-property-enum-value-removed

  • 698a0d89ab621See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog