> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# conversation.message

GET /

Receive conversation.message events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/conversation-message

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: conversation.message
  version: subpackage_conversationMessage.conversation.message
  description: Receive conversation.message events
channels:
  /:
    description: Receive conversation.message events
    publish:
      operationId: subpackage_conversationMessage.conversation.message-publish
      summary: conversation.message
      message:
        name: onConversationMessageConversationMessageEvent
        title: conversation.message
        payload:
          $ref: '#/components/schemas/conversation.message_conversationMessageEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsConversationMessageMessagesConversationMessageEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsConversationMessageMessagesConversationMessageEventJsonrpc
    ChannelsConversationMessageMessagesConversationMessageEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsConversationMessageMessagesConversationMessageEventMethod
    ChannelsConversationMessageMessagesConversationMessageEventParamsEventType:
      type: string
      enum:
        - conversation.message
      description: The event type — identifies which event this is.
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsEventType
    ChannelsConversationMessageMessagesConversationMessageEventParamsParamsText:
      oneOf:
        - type: string
        - description: Any type
      description: The message text. `null` on `conversation.message.updated`.
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsParamsText
    ChannelsConversationMessageMessagesConversationMessageEventParamsParamsConversationName:
      oneOf:
        - type: string
        - description: Any type
      description: Human-readable name of the conversation. May be `null`.
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsParamsConversationName
    ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden1:
      type: string
      enum:
        - 'true'
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden1
    ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden2:
      type: string
      enum:
        - 'false'
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden2
    ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden:
      oneOf:
        - type: boolean
        - $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden1
        - $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden2
      description: >-
        Whether the message is hidden. On `conversation.message` this may arrive
        as the string `"false"` rather than a boolean.
      title: >-
        ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden
    ChannelsConversationMessageMessagesConversationMessageEventParamsParams:
      type: object
      properties:
        id:
          type: string
          description: The message ID.
        type:
          type: string
          description: The message type.
        subtype:
          type: string
          description: >-
            The message subtype. Always `update` on
            `conversation.message.updated`.
        kind:
          type: string
          description: The message kind.
        ts:
          type: number
          format: double
          description: >-
            When the message was created, as a Unix timestamp in seconds with a
            fractional part.
        text:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParamsText
          description: The message text. `null` on `conversation.message.updated`.
        conversation_name:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParamsConversationName
          description: Human-readable name of the conversation. May be `null`.
        user_name:
          type: string
          description: Display name of the sender.
        details:
          type: object
          additionalProperties:
            description: Any type
          description: Additional message details.
        metadata:
          type: object
          additionalProperties:
            description: Any type
          description: Customer-provided metadata for the message.
        group_id:
          type: string
          description: Identifier of the conversation group.
        from_fabric_address_id:
          type: string
          description: The Resource address the message was sent from.
        hidden:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParamsHidden
          description: >-
            Whether the message is hidden. On `conversation.message` this may
            arrive as the string `"false"` rather than a boolean.
      description: The event-specific payload.
      title: ChannelsConversationMessageMessagesConversationMessageEventParamsParams
    ChannelsConversationMessageMessagesConversationMessageEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: The subscriber's Conversation stream this event was delivered on.
        timestamp:
          type: string
          description: >-
            When the event was emitted, as a string-encoded epoch timestamp. The
            unit

            differs by event: `conversation.message` and `conversation.joined`
            send

            fractional seconds (e.g. `"1712345678.842113"`);
            `conversation.message.updated`

            and `conversation.broadcast` send milliseconds (e.g.
            `"1712345678842"`).
        is_author:
          type: boolean
          description: Whether the receiving subscriber authored this message.
        params:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParamsParams
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - is_author
        - params
      description: The event envelope.
      title: ChannelsConversationMessageMessagesConversationMessageEventParams
    conversation.message_conversationMessageEvent:
      type: object
      properties:
        jsonrpc:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventJsonrpc
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventMethod
          description: Always `signalwire.event`.
        params:
          $ref: >-
            #/components/schemas/ChannelsConversationMessageMessagesConversationMessageEventParams
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires on a subscriber's Conversation stream when a new message is
        published to a

        conversation the subscriber is part of. `params` carries the merged
        message payload and

        stream metadata. The envelope `timestamp` is a string of Unix seconds
        with a fractional

        part, for example `"1712345678.842113"`.
      title: conversation.message_conversationMessageEvent

```