Microsoft Teams Bot icon

Microsoft Teams Bot

Use Bot Framework conversation and activity APIs for Microsoft Teams bots

Actions23

Proactive → Upsert Reference

AI-generated

Summary

Create or update a proactive message reference in the node's global conversation reference store by specifying a unique reference key and either providing a JSON object for the reference or service URL and conversation ID details.

Inputs

  • Service URL (required) — Bot Framework service URL, typically from trigger output, used if Reference JSON is not provided.
  • Conversation ID (required) — Conversation ID, typically from trigger output, used if Reference JSON is not provided.
  • Reference Key (required) — Unique key to identify the proactive reference for creation or update operations.
  • Reference JSON — Optional JSON object representing the entire proactive reference; overrides the Service URL and Conversation ID if set.
  • Execution Options — Optional collection of options including debug output, output mode (pass through, merge, response only), and retry parameters for API requests.

Output shape

a single JSON object containing the reference key and the stored reference object

The operation stores the reference in the node's global static data. When Reference JSON is provided, it is parsed and stored (must be an object). Otherwise, the reference is built from the Service URL and Conversation ID fields. The stored reference includes a lastSeenAt timestamp. The output contains the full stored reference details under 'reference'. Errors occur if mandatory inputs are missing or input JSON is invalid.

Links

Discussion