Nashir Contact icon

Nashir Contact

Manage contacts and retrieve knowledge from nashir.ai

Actions8

Tag Contact

AI-generated

Summary

Add or remove CRM tags on a specific contact identified by business ID, channel, and channel ID. The operation applies only existing tag keys defined for the business and rejects unknown tags.

Inputs

  • Business ID (required) — Business that owns the contact. Must be a positive integer and belong to the team associated with the API key. Typically wired from the webhook payload.
  • Channel (required) — Channel of the conversation, such as whatsapp_dm, facebook, instagram, or website_chat. Both inbound and CRM vocabularies are accepted, but unrecognized values are rejected.
  • Channel ID (required) — Platform-specific sender ID from the inbound webhook, e.g., WhatsApp phone number, Facebook PSID, Instagram IGSID, or website-chat visitor ID.
  • Add Tags — Comma-separated tag keys to add to the contact. All tag keys must already exist for the business; unknown keys cause the operation to be rejected.
  • Remove Tags — Comma-separated tag keys to remove from the contact.

Output shape

a list of JSON objects representing the updated contact data or error information per input item

If both addTags and removeTags are empty, an error is thrown. All tags provided in addTags must exist for the business; otherwise, the request is rejected. Errors propagate unless 'Continue On Fail' is enabled, in which case error messages are returned in the output JSON.

Examples

Example 1: Add 'vip' and remove 'awaiting_reply' tags from a contact

Provide Business ID, Channel, Channel ID from webhook data; set Add Tags to 'vip'; set Remove Tags to 'awaiting_reply'.

Links

Discussion