# Intercom Playbooks

### Provide your Intercom AI agent with conversation attributes from Intercom to answer user data specific questions

If you already capture lots of information on your users in Intercom, you may find it useful to provide this information to your AI agent as context so it can refer back to that information in its responses.

To do this, you will need to make a workflow where, when a conversation is initiated an Internal note is generated on the first message that contains the relevant conversation attributes.

<figure><img src="/files/C4wM6An4BnCeaMqc0YEI" alt=""><figcaption></figcaption></figure>

### How to give your Intercom AI agent context about what page the user is on to better answer questions

There are a couple of ways you can give your Intercom AI agent context about what page the user is on to better answer questions:

1. [Create an API](/features/user-data-api.md) that we can send an email to (for a logged in user) and you return information about the current page of the user + other useful information. \
   \
   This approach is the best long term one as you can keep feeding in more information about that user's account.
2. [You can add a note](#provide-your-intercom-ai-agent-with-conversation-attributes-from-intercom-to-answer-user-data-specif), as part of the current workflow, just before the user is asked to type their question. \
   \
   You can add in static and dynamic content here (from Intercom), so if you're able to add the current user's page as a user attribute, you can feed it in here. \
   \
   The AI will look at this note as well as the user's message for context.

You can even do both.

Option #1 will help give the AI additional knowledge about the user, and Option #2 will enrich that user's question to be more contextual to where they are.

### How to collect email on handover/escalation in Intercom

When a Intercom conversation has been handed over or escalated to an agent, you will likely want to collect the email address of the user or customer if they were a visitor.

To do this, [follow our guide on escalation data collection here](/features/escalation-data-collection.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://support.myaskai.com/features/channels/intercom/intercom-playbooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.