---
title: "SendToConversation"
method: POST
path: "/v3/conversations/{conversationId}/activities"
tags: ["Conversations"]
---

# SendToConversation

`POST /v3/conversations/{conversationId}/activities`

## Request

- Base URL: `https://api.botframework.com`
- URL: `https://api.botframework.com/v3/conversations/{conversationId}/activities`
- Auth: none declared
- TypeScript: <https://skmtc.dev/poshbotio/apis/microsoft-bot-connector-api-v3-0/docs/v3/conversations/:conversationId/activities/post.ts> (a function with typed inputs; its response is checked against the schema)

This method allows you to send an activity to the end of a conversation.

This is slightly different from ReplyToActivity().
* SendToConverstion(conversationId) - will append the activity to the end of the conversation according to the timestamp or semantics of the channel.
* ReplyToActivity(conversationId,ActivityId) - adds the activity as a reply to another activity, if the channel supports it. If the channel does not support nested replies, ReplyToActivity falls back to SendToConversation.

Use ReplyToActivity when replying to a specific activity in the conversation.

Use SendToConversation in all other cases.

## Path parameters

- `conversationId` string, required

## Request body

- Activity: An Activity is the basic communication type for the Bot Framework 3.0 protocol
  - `type` 'message' | 'contactRelationUpdate' | 'conversationUpdate' | 'typing' | 'ping' | 'endOfConversation' | 'event' | 'invoke' | 'deleteUserData' | 'messageUpdate' | 'messageDelete' | 'installationUpdate' | 'messageReaction' | 'suggestion' | 'trace': Types of Activities
  - `id` string: ID of this activity
  - `timestamp` string, date-time: UTC Time when message was sent (set by service)
  - `localTimestamp` string, date-time: Local time when message was sent (set by client, Ex: 2016-09-23T13:07:49.4714686-07:00)
  - `serviceUrl` string: Service endpoint where operations concerning the activity may be performed
  - `channelId` string: ID of the channel where the activity was sent
  - `from` ChannelAccount: Channel account information needed to route a message
    - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
    - `name` string: Display friendly name
    - `role` 'user' | 'bot'
  - `conversation` ConversationAccount: Channel account information for a conversation
    - `isGroup` boolean: Indicates whether the conversation contains more than two participants at the time the activity was generated
    - `conversationType` string: Indicates the type of the conversation in channels that distinguish between conversation types
    - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
    - `name` string: Display friendly name
    - `role` 'user' | 'bot'
  - `recipient` ChannelAccount: Channel account information needed to route a message
    - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
    - `name` string: Display friendly name
    - `role` 'user' | 'bot'
  - `textFormat` 'markdown' | 'plain' | 'xml': Text format types
  - `attachmentLayout` 'list' | 'carousel': Attachment layout types
  - `membersAdded` ChannelAccount[]: Members added to the conversation
    - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
    - `name` string: Display friendly name
    - `role` 'user' | 'bot'
  - `membersRemoved` ChannelAccount[]: Members removed from the conversation
    - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
    - `name` string: Display friendly name
    - `role` 'user' | 'bot'
  - `reactionsAdded` MessageReaction[]: Reactions added to the activity
    - `type` 'like' | 'plusOne': Message reaction types
  - `reactionsRemoved` MessageReaction[]: Reactions removed from the activity
    - `type` 'like' | 'plusOne': Message reaction types
  - `topicName` string: The conversation's updated topic name
  - `historyDisclosed` boolean: True if prior history of the channel is disclosed
  - `locale` string: The language code of the Text field
  - `text` string: Content for the message
  - `speak` string: SSML Speak for TTS audio response
  - `inputHint` 'acceptingInput' | 'ignoringInput' | 'expectingInput': Indicates whether the bot is accepting, expecting, or ignoring input
  - `summary` string: Text to display if the channel cannot render cards
  - `suggestedActions` SuggestedActions: SuggestedActions that can be performed
    - `to` string[]: Ids of the recipients that the actions should be shown to. These Ids are relative to the channelId and a subset of all recipients of the activity
    - `actions` CardAction[]: Actions that can be shown to the user
      - `type` 'openUrl' | 'imBack' | 'postBack' | 'playAudio' | 'playVideo' | 'showImage' | 'downloadFile' | 'signin' | 'call' | 'payment' | 'messageBack': Types of actions
      - `title` string: Text description which appears on the button
      - `image` string: Image URL which will appear on the button, next to text label
      - `text` string: Text for this action
      - `displayText` string: (Optional) text to display in the chat feed if the button is clicked
      - `value` object: Supplementary parameter for action. Content of this property depends on the ActionType
  - `attachments` Attachment[]: Attachments
    - `contentType` string: mimetype/Contenttype for the file
    - `contentUrl` string: Content Url
    - `content` object: Embedded content
    - `name` string: (OPTIONAL) The name of the attachment
    - `thumbnailUrl` string: (OPTIONAL) Thumbnail associated with attachment
  - `entities` Entity[]: Collection of Entity objects, each of which contains metadata about this activity. Each Entity object is typed.
    - `type` string: Entity Type (typically from schema.org types)
  - `channelData` object: Channel-specific payload
  - `action` string: ContactAdded/Removed action
  - `replyToId` string: The original ID this message is a response to
  - `label` string: Descriptive label
  - `valueType` string: Unique string which identifies the shape of the value object
  - `value` object: Open-ended value
  - `name` string: Name of the operation to invoke or the name of the event
  - `relatesTo` ConversationReference: An object relating to a particular point in a conversation
    - `activityId` string: (Optional) ID of the activity to refer to
    - `user` ChannelAccount: Channel account information needed to route a message
      - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
      - `name` string: Display friendly name
      - `role` 'user' | 'bot'
    - `bot` ChannelAccount: Channel account information needed to route a message
      - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
      - `name` string: Display friendly name
      - `role` 'user' | 'bot'
    - `conversation` ConversationAccount: Channel account information for a conversation
      - `isGroup` boolean: Indicates whether the conversation contains more than two participants at the time the activity was generated
      - `conversationType` string: Indicates the type of the conversation in channels that distinguish between conversation types
      - `id` string: Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
      - `name` string: Display friendly name
      - `role` 'user' | 'bot'
    - `channelId` string: Channel ID
    - `serviceUrl` string: Service endpoint where operations concerning the referenced conversation may be performed
  - `code` 'unknown' | 'completedSuccessfully' | 'userCancelled' | 'botTimedOut' | 'botIssuedInvalidMessage' | 'channelFailed': Codes indicating why a conversation has ended
  - `expiration` string, date-time: DateTime to expire the activity as ISO 8601 encoded datetime
  - `importance` string: Importance of this activity {Low|Normal|High}, null value indicates Normal importance see ActivityImportance)
  - `deliveryMode` string: Hint to describe how this activity should be delivered. Currently: null or "Default" = default delivery "Notification" = notification semantics
  - `textHighlights` TextHighlight[]: TextHighlight in the activity represented in the ReplyToId property
    - `text` string: plain text fragment to highlight
    - `occurence` integer: index of occurence of the Text (Starting at 1)

## Response `200`

An object will be returned containing the ID for the resource.

- ResourceResponse: A response containing a resource ID
  - `id` string: Id of the resource

## Other responses

- `201`: A ResourceResponse object will be returned containing the ID for the resource.
- `202`: An object will be returned containing the ID for the resource.
- `default`: The operation failed and the response is an error object describing the status code and failure.

---

[API](https://skmtc.dev/poshbotio/apis/microsoft-bot-connector-api-v3-0.md) - [All operations](https://skmtc.dev/poshbotio/apis/microsoft-bot-connector-api-v3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/poshbotio/apis/microsoft-bot-connector-api-v3-0/revisions/ea45ea47a3fb?raw)