# Intercom
## O que é o Intercom**?**
A **Intercom** é uma plataforma de comunicação empresarial que facilita o contato entre empresas e clientes, oferecendo chat ao vivo, automação de marketing e gerenciamento de tickets de suporte. Com recursos como chatbots, base de conhecimento e análise de dados.
### 1. Como funciona essa integração?
Quando um aluno acessa a sua área de membros na Waid, o widget do **Messenger do Intercom** (aquele balãozinho de chat) é carregado na página. Junto com ele, a Waid envia automaticamente algumas informações sobre o aluno para o seu Intercom.
Diferente de uma integração baseada em eventos, aqui a Waid envia **atributos do contato** (*Custom Data Attributes*). Esses atributos ficam gravados diretamente no contato do aluno dentro do Intercom, vinculados pelo **e-mail** dele.
Em resumo: sempre que o aluno entra na área de membros, o Intercom recebe a "foto" atual de **quais turmas/grupos** e **quais áreas de membros** ele faz parte.
**O que você ganha com isso?**
Com esses atributos no Intercom, sua equipe de Marketing, Vendas e Suporte pode:
* **Segmentar contatos:** Criar segmentos como "alunos da Turma Scale" ou "alunos da Área Premium".
* **Automatizar mensagens (Series):** Disparar campanhas, e-mails ou chats direcionados a uma turma ou área específica.
* **Atender com contexto:** Ver, direto no perfil do contato (Inbox), a quais turmas e áreas o aluno pertence.
* **Direcionar conteúdo:** Mostrar banners, posts e mensagens específicas por turma/área.
> **Atenção:** Essa integração funciona em **mão única** (da Waid para o Intercom). Nós apenas atualizamos os atributos do contato; alterações feitas no Intercom não voltam para a Waid.
***
### 2. Quais informações a Waid envia para o Intercom?
Atualmente, a Waid envia os seguintes dados, que aparecem no perfil do contato no Intercom:
| O que é na Waid | Quando é enviado | Como chega no seu Intercom |
| ------------------------- | ---------------------------- | ----------------------------------------------------------------------------------- |
| Nome do aluno | Ao acessar a área de membros | Atributo padrão `name` (Nome) |
| E-mail do aluno | Ao acessar a área de membros | Identificador do contato (`email`) |
| Turmas / Grupos do aluno | Ao acessar a área de membros | Atributo personalizado **`Waid Groups`** (texto, nomes separados por vírgula) |
| Áreas de membros do aluno | Ao acessar a área de membros | Atributo personalizado **`Waid Members Area`** (texto, nomes separados por vírgula) |
Exemplos de valores que chegam no Intercom:
* `Waid Groups`: `Grupo Scale, Grupo Highticket`
* `Waid Members Area`: `Área Premium, Área de Mentoria`
> **Nota:** Esta integração envia **atributos de perfil**, não eventos de jornada. Ações como matrícula, progresso de curso, certificado, pagamentos ou login **não** são enviadas por esta integração no momento.
> **Atualização contínua:** Os atributos são reenviados toda vez que o aluno acessa a área de membros. Assim, se ele entrar em uma nova turma, o atributo será atualizado no próximo acesso dele.
***
### 3. Como o Intercom reconhece o aluno?
A chave de ligação entre a Waid e o Intercom é o **e-mail do aluno**.
* Se o aluno já existir no seu Intercom com aquele e-mail, os atributos são atualizados no contato dele.
* Se o aluno ainda não existir, o Intercom cria um novo contato automaticamente (como **Usuário**), usando o e-mail.
> **Dica de Ouro:** Para evitar contatos duplicados, oriente seus alunos a usarem o mesmo e-mail tanto nas comunicações com sua empresa quanto no login da plataforma Waid.
***
### 4. Mão na massa: O que você precisa configurar no Intercom
Para que os dados comecem a chegar, sua equipe precisa realizar algumas configurações rápidas. Siga o passo a passo:
#### Passo 1: Pegar o App ID (ID do workspace) do seu Intercom
A Waid precisa saber para qual workspace do Intercom enviar os dados.
1. No seu Intercom, acesse **Settings** (Configurações) → **Installation** (Instalação) → **Web**.
2. Localize o seu **App ID** (também chamado de Workspace ID). Ele aparece no trecho de código de instalação, no formato `app_id: "abcd1234"`.
3. **Envie esse App ID para a equipe da Waid** (ou cadastre-o nas configurações de integração da sua plataforma Waid). Sem ele, a integração não sabe para onde enviar os dados.
> **Observação:** O App ID **não** é uma senha secreta — ele já fica visível no código do Messenger no seu site. Mesmo assim, envie-o pelos canais oficiais para evitar erros de digitação.
#### Passo 2: Garantir o Messenger ativo e o plano adequado
* O **Messenger** do Intercom precisa estar habilitado (é ele que carrega na área de membros e envia os dados).
* O recurso de **Custom Data Attributes** está disponível em **qualquer plano pago** do Intercom (inclusive o plano de entrada). **Não exige plano Enterprise.**
**Até o Passo 2 segue igual a documentação antiga:** [**https://help.curseduca.com/integracoes/intercom**](https://help.curseduca.com/integracoes/intercom)
#### Passo 3: Preparar os atributos personalizados (Custom Data Attributes)
Você precisa "preparar o terreno" no Intercom para receber os dois atributos da Seção 2.
1. No Intercom, acesse **Settings** → **Data** → **People** (Pessoas) → **Data attributes** (Atributos de dados).
2. Crie (ou confirme que existem) os dois atributos abaixo, **do tipo Texto (Text)**:
| Nome do atributo | Tipo | O que guarda |
| ------------------- | ----- | ------------------------------------ |
| `Waid Groups` | Texto | Nomes das turmas/grupos do aluno |
| `Waid Members Area` | Texto | Nomes das áreas de membros (tenants) |
1. **Muito importante:** em cada um desses atributos, garanta que a opção **"Prevent updates via the Messenger"** (Impedir atualizações via Messenger) esteja **DESLIGADA**. Se ela estiver ligada, o Intercom **descarta silenciosamente** os valores enviados pela Waid, e o atributo aparece como "Unknown".
#### Passo 4: Ativação Final
Assim que recebermos o seu App ID (Passo 1) e os atributos estiverem preparados no Intercom (Passo 3), a integração estará ativa. A partir daí, sempre que um aluno acessar a área de membros, os atributos `Waid Groups` e `Waid Members Area` serão enviados ao seu Intercom.
***
### 5. Resumo de Responsabilidades
Para ficar claro quem faz o quê:
| O que precisa ser feito | De quem é a responsabilidade |
| ------------------------------------------------------------------- | ---------------------------- |
| Detectar as turmas/grupos e áreas do aluno na plataforma | Equipe Waid |
| Enviar os atributos para o Intercom (via Messenger) | Equipe Waid |
| Ter conta no Intercom com o Messenger ativo | Sua Equipe (Cliente) |
| Informar o App ID (ou cadastrá-lo nas configurações da plataforma) | Sua Equipe (Cliente) |
| Criar os atributos `Waid Groups` e `Waid Members Area` (tipo Texto) | Sua Equipe (Cliente) |
| Desligar "Prevent updates via the Messenger" nesses atributos | Sua Equipe (Cliente) |
| Configurar/ativar o App ID no sistema da Waid | Equipe Waid |
| Criar segmentos, automações (Series) e relatórios | Sua Equipe (Cliente) |
***
### 6. Como testar se deu tudo certo?
Depois que a integração estiver ativa, faça um teste rápido:
1. Garanta que o seu aluno de teste pertence a **pelo menos uma turma/grupo** e a **uma área de membros**.
2. Faça **login na área de membros** da Waid com esse aluno e **carregue a página** (dê um "atualizar" / F5 para garantir o envio).
3. Abra o seu Intercom e procure pelo **contato com o e-mail** desse aluno de teste.
4. No painel **Detalhes** do contato, procure os atributos `Waid Groups` e `Waid Members Area`. Eles devem mostrar os nomes das turmas e áreas (ex: `Grupo Scale, Grupo Highticket`).
* Dica: use a caixa de busca de detalhes do contato e digite `Waid` para encontrá-los rapidamente.
5. Se quiser ir além, crie um **Segmento** no Intercom filtrando por esses atributos e veja se o aluno de teste aparece nele.
**Não apareceu (ou está "Unknown")? Verifique:**
* O **App ID** foi informado corretamente?
* A opção **"Prevent updates via the Messenger"** está **desligada** nos dois atributos?
* Lembre do comportamento da "primeira carga": se foi a primeira vez que o atributo chegou, o valor só preenche no **acesso seguinte** — acesse a área de membros mais uma vez.
* O aluno realmente está em alguma turma/área? Se estiver vazio, nada é enviado.
Se tudo estiver certo e mesmo assim não funcionar, abra um chamado com nosso suporte informando o e-mail do aluno testado e o horário do teste.
***
### 7. Pontos de Atenção (Limitações)
* **Plano do Intercom:** O Messenger e os *Custom Data Attributes* estão disponíveis em **qualquer plano pago** do Intercom (inclusive o de entrada).
* **Atributos, não eventos:** Esta integração envia atributos de perfil (turmas e áreas). Ela **não** registra eventos de jornada (matrícula, progresso, certificado, pagamentos, login).
* **Identificação por e-mail:** O contato é reconhecido/criado pelo e-mail do aluno.
* **Atualização no acesso:** Os atributos só são (re)enviados quando o aluno **acessa a área de membros**. Se o aluno entrar em uma nova turma, mas não acessar a plataforma, o atributo só será atualizado no próximo acesso dele.
* **Estado atual, não histórico:** Os atributos refletem a situação **atual** do aluno (turmas/áreas que ele tem agora). Não há um histórico cronológico de quando ele entrou ou saiu de cada turma.
* **Multi-valor como texto:** Turmas e áreas são enviadas como **texto separado por vírgula** (e não como uma "lista" nativa do Intercom, que é limitada e de valor único). Para segmentar por uma turma específica, use o filtro **"contém" (contains)** no Intercom.
* **Mão única:** Alterações feitas no Intercom não refletem na plataforma Waid.
---
# 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://help.curseduca.com/integracoes/intercom.md?ask=
```
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.