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

# Attio

> Sincronize pessoas nos dois sentidos com o Attio, registre as conversas na timeline do Attio e envie modelos de WhatsApp a partir dos workflows e dos registros do Attio.

A integração com o Attio mantém seus contatos em dia entre o Attio e a Ciarem. As pessoas (People) do Attio viram contatos da Ciarem que os modelos, a IA e a Caixa de entrada podem usar. As conversas e os envios de modelos aparecem na timeline da pessoa no Attio, e sua equipe pode enviar modelos de WhatsApp a partir dos workflows do Attio e do registro de uma pessoa. Os administradores a configuram em **Configurações > Integrações > Attio**.

A Ciarem funciona com um CRM por vez: você pode conectar o HubSpot, o Attio ou o [RD Station CRM](https://help.ciarem.ai/pt/integrations/rdstation.md), só um deles. Para trocar, desconecte primeiro o que você tem.

## Planos

O Attio está incluído no **Growth** e no **Scale**, e durante o teste gratuito. Não está incluído no **Solo**. Não é possível escolher o Solo com o Attio ainda conectado: desconecte-o antes, ou escolha Growth ou Scale. Veja [Planos e faturamento](https://help.ciarem.ai/pt/billing/plans-and-billing.md).

Se o seu teste terminar ou a assinatura parar, o Attio continua conectado, mas nada sincroniza em nenhum sentido. Quando você assina o Growth ou o Scale, a sincronização volta sozinha. Um contato que você editou na Ciarem enquanto a sincronização estava parada chega ao Attio na próxima vez que mudar.

## Conectar o Attio

**1. Abra a integração com o Attio**

Vá em **Configurações**, depois em **Integrações**, e clique em **Conectar** no cartão do Attio.

**2. Aprove o acesso no Attio**

Entre no Attio, escolha seu workspace e aprove o acesso da Ciarem. Isso também instala o app da Ciarem no seu workspace do Attio. Até o app da Ciarem estar na App Store do Attio, o Attio mostra um aviso de que o app não foi aprovado. Clique em **Allow** para continuar.

**3. Conclua a configuração do Attio**

De volta à Ciarem, uma configuração em três etapas pede as etapas do seu funil, seu mapeamento de atributos e o proprietário do contato, e seus filtros de importação. Clique em **Concluir** para salvar e iniciar a sincronização. Nada sincroniza até você concluí-la, então suas escolhas valem desde a primeira pessoa.

Se você fechar a configuração, a integração mostra **Configuração parcial**. Clique em **Concluir configuração** para voltar a ela. Depois da configuração, mude o que quiser nas abas **Etapas do funil**, **Mapeamento de atributos**, **Filtros de importação** e **Tarefas** (e **Empresas**, quando aparece) e clique em **Salvar alterações**.

### O que a Ciarem adiciona ao Attio

Ao conectar, um atributo de texto é adicionado a People no Attio, **Ciarem contact ID**. Ao ativar [Empresas](#empresas), outro é adicionado a Companies, **Ciarem company ID**. A Ciarem grava ali o próprio ID para manter cada registro do Attio vinculado ao contato ou à empresa na Ciarem, então não edite nem exclua esses atributos. A Ciarem não cria, edita nem exclui nenhum outro atributo de People ou Companies, nem nenhum status.

## Enquanto o Attio está conectado

Os contatos são gerenciados no Attio. A seção **Contatos** fica oculta na Ciarem, e as variáveis de modelo usam os dados sincronizados do Attio. Na Caixa de entrada, o painel de detalhes de uma conversa mostra a **Última sincronização com Attio** e um link **Ver no Attio**.

## O que sincroniza

* **Pessoas, nos dois sentidos.** Aqui as pessoas (People) sincronizam, e as [empresas](#empresas) também quando o complemento está ativo. Os negócios não sincronizam. Uma pessoa do Attio é importada quando tem um número de telefone válido com o código do país. Um contato criado ou editado na Ciarem é gravado no Attio (nome, e-mail, telefone e Instagram) assim que a Ciarem sabe o nome ou o e-mail dele. Um contato que só tem número de telefone não é enviado. Se já existe no Attio uma pessoa com o mesmo e-mail, a Ciarem se vincula a essa pessoa em vez de criar uma nova. Quando a Ciarem grava um e-mail, o Attio pode criar ou vincular por conta própria uma empresa a partir do domínio do e-mail. Quando uma pessoa tem vários e-mails ou telefones, a Ciarem usa o primeiro e-mail e o primeiro telefone válido. Quando a Ciarem grava um e-mail ou telefone no Attio, ela o adiciona à lista da pessoa e nunca remove os outros.
* **Sincronizados automaticamente.** Nome, e-mail, telefone, cidade e Instagram sincronizam em cada pessoa sem nenhum mapeamento.
* **Mapeamento de atributos.** Na aba **Mapeamento de atributos**, escolha atributos do Attio para trazer para propriedades de contato da Ciarem, para que os modelos e a IA possam usá-los. Escolha uma propriedade da Ciarem para cada um, ou **Criar a partir do Attio** para criar uma igual. Os atributos mapeados sincronizam do Attio para a Ciarem. Cada propriedade mapeada precisa de uma **Descrição para a IA**: é com ela que a IA aprende o que a propriedade significa e quando usá-la, então escreva como uma instrução.
* **Filtros de importação.** Na aba **Filtros de importação**, adicione condições para escolher quais pessoas são importadas. Só entram as pessoas que atendem a todas as condições. Sem filtros, todos com um telefone válido são importados. Quem já está na Ciarem continua sincronizando.
* **Proprietário do contato.** Em **Proprietário do contato**, escolha o atributo do Attio que indica o proprietário. A partir daí o proprietário sincroniza nos dois sentidos, para os colegas cujo e-mail é membro do seu workspace do Attio. Escolha **Não sincronizar proprietários** para deixá-los de fora.
* **Etapas do funil.** Na aba **Etapas do funil**, escolha um atributo de status de People no Attio. Os status dele viram suas etapas na Ciarem. O Attio é dono dos status e da ordem, então você adiciona, renomeia ou reordena no Attio. Descreva cada etapa para que a IA saiba quando um contato pertence ali. Para deixar a IA mover contatos para uma etapa, clique no botão **IA desligada** ao lado dela (todas as etapas menos a primeira) e escolha quais agentes podem mover contatos para ela e quando. Quando a IA move um contato em uma conversa real, a Ciarem grava o novo status na pessoa no Attio. O Playground só mostra a mudança; não a grava. Até você escolher um atributo, as etapas do funil ficam desligadas.
* **Tarefas, nos dois sentidos.** **Sincronizar tarefas** (aba **Tarefas**) fica ativo a menos que você o desligue. Enquanto está ativo, as [tarefas](https://help.ciarem.ai/pt/using-ciarem/tasks.md) de um contato e as tarefas da pessoa no Attio ficam iguais: título e nota, data de vencimento e conclusão. As tarefas que a Ciarem cria no Attio não têm responsável, e prioridade e tipo não sincronizam. O Attio não permite editar o texto de uma tarefa, então mudar o título ou a nota de uma tarefa na Ciarem substitui a tarefa no Attio. As tarefas do Attio só são importadas quando estão vinculadas a uma pessoa sincronizada com a Ciarem.
* **Conversas na linha do tempo.** Conversas abertas e resolvidas, e modelos de WhatsApp enviados, aparecem na aba Activity da pessoa no Attio, com um link de volta para a Ciarem. O Attio agrupa essas entradas em **automation events** na aba Activity: clique para vê-las.

> [!NOTE]
>
> As entradas na linha do tempo precisam das atividades personalizadas do Attio. Se o seu workspace não tiver esse recurso, a página do Attio na Ciarem mostra **As entradas na linha do tempo estão desligadas**, e as entradas aparecem quando o workspace tiver. Todo o resto sincroniza normalmente.

### Ainda não tem um atributo de status?

As pessoas no Attio não vêm com um atributo de status. Se você não tiver um, a aba **Etapas do funil** avisa. No Attio, abra People, adicione um atributo do tipo Status (por exemplo Etapa do lead) com suas etapas e volte para escolhê-lo.

Se depois você trocar para outro atributo, suas etapas são substituídas pelos status dele, os contatos são posicionados de novo pelo status no Attio e as configurações de IA das etapas atuais se perdem.

## Empresas

As empresas também sincronizam com o Attio, quando duas coisas estão em ordem:

1. **Ative o complemento Empresas** em **Configurações > Complementos**. Veja [Empresas](https://help.ciarem.ai/pt/using-ciarem/companies.md).
2. **Conclua a configuração do Attio.** Não há nada para reconectar: se o Attio já estava conectado, as empresas começam a sincronizar sozinhas em poucos minutos depois que o complemento é ativado (a aba **Empresas** avisa).

O Attio é onde suas empresas são gerenciadas. A página **Empresas** continua oculta na Ciarem, como no HubSpot, mas as empresas aparecem no painel de detalhes de um contato na Caixa de entrada, e a IA e as variáveis das mensagens as usam.

* **Empresas e seus campos.** Cada empresa do Attio é importada com o nome e o domínio. O domínio sincroniza nos dois sentidos: uma empresa que você cria na Ciarem é adicionada ao Attio, ou vinculada à empresa do Attio que já tem esse domínio.
* **Mapeamento de atributos de empresa.** Na aba **Empresas**, em **Mapeamento de atributos de empresa**, escolha atributos de empresa do Attio para trazer para propriedades de empresa da Ciarem, para que os modelos e a IA possam usá-los. Escolha uma propriedade da Ciarem para cada um, ou **Criar a partir do Attio** para criar uma igual. Os atributos mapeados sincronizam do Attio para a Ciarem.
* **Proprietário da empresa.** Em **Proprietário da empresa**, escolha o atributo de empresa do Attio que indica o proprietário. O Attio não tem um atributo de proprietário padrão para empresas, então no início nada vem escolhido e os proprietários ficam de fora até você escolher um. O proprietário passa então a sincronizar nos dois sentidos, para colegas cujo e-mail é de um membro do seu workspace do Attio.
* **A empresa de uma pessoa.** A Company (empresa) de uma pessoa no Attio é a **empresa principal** desse contato na Ciarem, e vice-versa: quando você torna outra empresa a principal na Ciarem, ela passa a ser a Company da pessoa no Attio. O Attio guarda uma só empresa por pessoa, então as outras empresas que você vincula a um contato ficam só na Ciarem e nunca são enviadas ao Attio. Uma empresa vinculada pela IA só chega ao Attio depois que uma pessoa confirma o vínculo.
* **Empresas a partir de domínios de e-mail.** O Attio cria empresas por conta própria a partir do domínio do e-mail de uma pessoa, e vincula a pessoa a uma quando ela não tem nenhuma. Essas empresas são importadas para a Ciarem como qualquer outra. Essa é uma configuração do próprio Attio; para desativá-la, vá no Attio em **Settings > Workspace > Email and calendar > Record creation**. Desativar não remove nada que já existe.
* **Sem vinculação automática por domínio.** Enquanto o Attio estiver conectado, a Ciarem não vincula contatos a empresas pelo domínio do e-mail, porque o Attio faz isso.
* **Excluir uma empresa no Attio.** A empresa continua na Ciarem, com seus contatos e seus campos, e deixa de estar vinculada ao Attio. Uma empresa que ainda está vinculada ao Attio não pode ser excluída na Ciarem: exclua-a no Attio.

Se o domínio de uma empresa já pertence a outra empresa na Ciarem, o domínio é deixado como estava.

## Contatos não importados

Algumas pessoas do Attio não podem ser criadas na Ciarem. Depois da configuração, a página do Attio na Ciarem lista essas pessoas em **Contatos não importados**, cada uma com o motivo e um link **Abrir no Attio** para você corrigir lá:

* **Telefone já usado**: outro contato na Ciarem já tem este número de telefone.
* **E-mail já usado**: outro contato na Ciarem já tem este e-mail.
* **Instagram já usado**: outro contato na Ciarem já tem este usuário do Instagram.
* **Telefone inválido**: a pessoa não tem um número de telefone que a Ciarem possa usar. Adicione um com o código do país, por exemplo +55.

Corrija a pessoa no Attio, por exemplo mesclando os duplicados ou corrigindo o valor, e ela sincroniza sozinha.

## Enviar WhatsApp pelo Attio

O app da Ciarem no seu workspace do Attio adiciona duas formas de enviar um modelo de WhatsApp aprovado. As duas enviam pela Ciarem, então a pessoa já precisa estar sincronizada com um contato da Ciarem. O Attio mostra essas opções em inglês.

* **Etapa de workflow.** Em um workflow do Attio, adicione a etapa **Send WhatsApp template**. Escolha a pessoa em **Person** (normalmente a que iniciou o workflow), a linha em **WhatsApp line** e o modelo em **Template**. Só aparecem os modelos aprovados que a Ciarem consegue preencher. Em **Variable values (JSON)**, informe um valor por variável do modelo, como texto ou como uma referência `{{contact.…}}` que a Ciarem preenche, por exemplo `{"1": "{{contact.first_name}}"}`. Se as variáveis do modelo tiverem nome, use o nome como chave, por exemplo `{"contact_first_name": "{{contact.first_name}}"}`. A etapa termina como **Sent**, ou com um erro que explica o que deu errado.
* **Pelo registro de uma pessoa.** Em uma pessoa no Attio, abra o menu **More** (⋯), encontre o app da Ciarem e escolha **Send WhatsApp template**. Também está no menu de comandos do Attio (CMD+K). Escolha uma linha e um modelo, preencha os valores das variáveis e clique em **Send**.

## Mesclar pessoas no Attio

Quando você mescla duas pessoas no Attio, a pessoa mesclada continua vinculada à Ciarem. Se as duas estavam vinculadas a contatos diferentes da Ciarem, o segundo contato é desvinculado e mantém suas conversas; ele se vincula de novo se depois corresponder a uma pessoa.

## Excluir uma pessoa no Attio

Excluir uma pessoa no Attio desvincula essa pessoa da Ciarem. O contato da Ciarem e as conversas dele são mantidos.

## Reconectar

Se o app da Ciarem for removido no Attio, a integração mostra **Precisa reconectar**. Clique em **Reconectar** e aprove o acesso de novo. Escolha o mesmo workspace para manter suas configurações de sincronização. Escolher outro workspace remove a configuração e os vínculos com contatos.

## Desconectar

**Desconectar** interrompe a sincronização e traz de volta a seção Contatos na Ciarem. Seus contatos, as conversas deles e as etapas do funil ficam na Ciarem. Suas configurações de sincronização são apagadas, então conectar de novo repete a configuração; escolhendo o mesmo workspace, os contatos continuam vinculados às pessoas. Seus dados no Attio não são alterados. O app da Ciarem continua no seu workspace do Attio; para removê-lo também, desinstale-o nas configurações do Attio.


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