> ## Documentation Index
> Fetch the complete documentation index at: https://docs.conduit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact and conversation events

> Platform events for new contacts, contact attribute and label changes, conversation tags and escalations, with every filter they offer.

These events start an internal agent when a contact is created or changes, when a conversation is tagged, or when an agent escalates. See [Platform events](https://docs.conduit.ai/build-your-agent/agents/internal-agents/platform-events/overview.md) for how to add a trigger.

| Event | Runs when | Filters |
| - | - | - |
| [New contact](#new-contact) | A contact is created. | Inbox |
| [Contact attribute updated](#contact-attribute-updated) | A contact attribute changes. | Inbox, Run when |
| [Contact label added](#contact-label-added) | A label is added to a contact. | Label, Inbox |
| [Conversation tag added](#conversation-tag-added) | A conversation tag is added. | Tag, Inbox |
| [Escalation created](#escalation-created) | An escalation is created. | Inbox, Escalation type |

## New contact

Runs when a contact is created in Conduit, for example when someone messages you for the first time.

| Filter | Options |
| - | - |
| **Inbox** | Only run for contacts in this inbox. Empty runs for every inbox. |

**Example task:** "A new lead just came in. Look up their company from their email domain, add what you find as a note, and post the lead to #sales in Slack."

## Contact attribute updated

Runs when one of a contact's [custom attributes](https://docs.conduit.ai/inbox/setup/custom-fields.md) changes.

| Filter | Options |
| - | - |
| **Inbox** | Only run for contacts in this inbox. Pick an inbox to see the attribute filter. |
| **Run when** | Pick an attribute, a comparison and a value, for example "Lead status equals Qualified". |

**Example task:** "This contact's lead status changed. If it's now Qualified, create a follow-up task for the sales owner due tomorrow."

## Contact label added

Runs when a label is added to a contact.

| Filter | Options |
| - | - |
| **Label** | Only run when this label is added. |
| **Inbox** | Only run for contacts in this inbox. Empty runs for every inbox. |

## Conversation tag added

Runs when a [conversation tag](https://docs.conduit.ai/inbox/setup/conversation-tags.md) is added, whether by a teammate or by an agent.

| Filter | Options |
| - | - |
| **Tag** | Only run when this tag is added. |
| **Inbox** | Only run for conversations in this inbox. Required once you pick a tag. |

Tags are a cheap way to hand work from a customer agent to an internal agent. Have the customer agent tag the conversation when it sees something, such as an early check-in request, and let the internal agent act on that tag. This keeps the internal agent from reading every conversation itself.

**Example task:** "This conversation was tagged Early check-in. Check whether the unit is clean today. If it is, tell the guest the earliest time they can arrive. If not, add a note for the front desk."

## Escalation created

Runs when an escalation is created, so an internal agent can triage it, gather context, or alert the right person.

| Filter | Options |
| - | - |
| **Inbox** | Only run for escalations in this inbox. Empty runs for every inbox. |
| **Escalation type** | **Any escalation**, **AI missing info**, **AI needs help** or **AI conflicting info**. |

**Example task:** "The guest agent escalated because it was missing information. Search Knowledge and the listing's details for the answer. If you find it, add it as a note for the team. If not, post the question to #guest-support in Slack."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.