Actions12
消息 → 更新消息卡片
AI-generatedOverview
This node updates message cards in the Popo OpenPlatform Robot API. It allows users to modify existing message cards by specifying the template and instance identifiers, along with public and private variable maps to update the card's content. The node supports selective key updates and batch updates for private data limited to 20 users. This is useful for dynamically changing card content in messaging applications, such as updating status, information, or interactive elements in a card format.
Use Case Examples
- Updating a project status card by changing public variables to reflect new progress.
- Modifying private card data for specific users in a batch update scenario, such as personalized notifications.
- Selective key updates to avoid overwriting unchanged data in a message card.
Properties
| Name | Meaning |
|---|---|
| Template Uuid | The template identifier used when sending the card, specifying which card template to update. |
| Instance Uuid | The instance identifier of the card to be updated, uniquely identifying the card instance. |
| Public Variable Map | A JSON string representing the public data to update on the card, affecting all recipients. |
| Batch Private Variable Map | A JSON string representing private card data updates for up to 20 users, allowing personalized content. |
| Public Update By Key | Boolean flag indicating update mode for public data: false means overwrite and clear unspecified keys; true means update only specified keys. |
| Private Update By Key | Boolean flag indicating update mode for private data: false means overwrite and clear unspecified keys; true means update only specified keys. |
Output
JSON
instanceUuid- The unique identifier of the updated card instance.templateUuid- The template identifier used for the card.publicVariableMap- The updated public variable map after the operation.batchPrivateVariableMap- The updated batch private variable map after the operation.publicUpdateByKey- Indicates if the public update was by key or overwrite.privateUpdateByKey- Indicates if the private update was by key or overwrite.
Dependencies
- An API key credential for authenticating with the Popo OpenPlatform Robot API.
Troubleshooting
- Ensure that the JSON strings for publicVariableMap and batchPrivateVariableMap are correctly formatted to avoid parsing errors.
- Verify that the templateUuid and instanceUuid correspond to existing and valid card templates and instances to prevent update failures.
- Check API authentication credentials if requests fail due to authorization errors.