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

# Utilizar a CloudTalk com o Attio

> Saiba como as chamadas são tratadas e como a informação é sincronizada entre a CloudTalk e o Attio.

<Note>
  Neste guia, mostramos-lhe como tirar o máximo partido da utilização da CloudTalk em conjunto com o Attio, incluindo como funciona a sincronização de contactos, onde são registadas as chamadas e os SMS e como utilizar um objeto de chamada personalizado para obter relatórios estruturados.
</Note>

**Nível de utilizador:** Administradores, Agentes, Supervisores

***

<Warning>
  **Pronto para configurar a integração CloudTalk + Attio?**\
  Siga as instruções passo a passo do nosso guia [Configurar o Attio](/pt/articles/16815852-configure-attio).
</Warning>

<h2 id="h_dabd44a269">
  Sincronização de contactos
</h2>

<h3 id="h_784c7772bc">
  Do Attio para a CloudTalk
</h3>

Quando ativa a integração, a CloudTalk importa todas as pessoas do seu workspace do Attio como contactos da CloudTalk. Depois, uma sincronização agendada recolhe automaticamente as pessoas recém-adicionadas, para que a sua lista de contactos se mantenha atualizada sem intervenção.

<h3 id="h_95831827b8">
  Da CloudTalk para o Attio
</h3>

Os contactos que cria ou edita na CloudTalk são escritos no objeto People do Attio. A correspondência é feita pelo endereço de email, pelo que as pessoas já existentes são atualizadas em vez de duplicadas.

<h3 id="h_d233bf94e6">
  Contactos criados durante as chamadas
</h3>

Se alguém ligar de um número que o Attio não reconhece, a CloudTalk cria a pessoa ao registar a chamada, para que o registo tenha sempre onde ficar.

Para o evitar, desative **Criar novos contactos no Attio para números de chamada não associados** nas Definições do fluxo de trabalho da sua integração. Nesse caso, a CloudTalk ignora tanto a nova pessoa como a respetiva chamada.

<h2 id="h_18fcf47aac">
  Registo de chamadas
</h2>

Todas as chamadas processadas através da CloudTalk são registadas automaticamente no Attio. Escolhe o formato no menu pendente **Como as chamadas são registadas**, nas definições da integração.

<h3 id="h_e9ffbfef44">
  Opção 1: Notas (predefinição)
</h3>

Cada chamada passa a ser uma nota no registo de pessoa do contacto. Não há nada para configurar: sem objeto, sem mapeamento de campos.

Cada nota contém a direção e o estado da chamada, a Inteligência Conversacional de IA (resumo, sentimento, tópicos), as notas do agente, as etiquetas, os números de telefone da CloudTalk e do cliente, o nome do agente, a duração, a data da chamada e as ligações para a gravação e para o perfil do contacto na CloudTalk.

As notas são escritas em Markdown para se lerem bem no Attio. Quando as etiquetas, as notas ou os dados de IA chegam depois de a chamada terminar, a CloudTalk atualiza a nota automaticamente.

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/cbc8cc570bed-screenshot-2026-09-04-at-09-59-52.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=4fbd63032eb092fa3c576a9d43e49956" alt="" width="450" data-path="images/help-center/articles/16815902/cbc8cc570bed-screenshot-2026-09-04-at-09-59-52.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/175d11746c36-screenshot-2026-09-04-at-10-04-15.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=5b8e5a0ad3ba9f3bf2e3bf44a392dd6a" alt="" width="350" data-path="images/help-center/articles/16815902/175d11746c36-screenshot-2026-09-04-at-10-04-15.png" />
</Frame>

<h3 id="h_e18cca1f1f">
  Opção 2: Objeto de chamada personalizado
</h3>

Selecione **Registar chamadas num objeto Call personalizado** e indique à CloudTalk um objeto que criou no Attio. As chamadas passam a ser registos estruturados que pode filtrar, agrupar, analisar em relatórios e automatizar. Tudo o que o Attio consegue fazer com um registo, consegue fazer com uma chamada.

Para instruções de configuração, consulte a secção [Configurar um objeto de chamada no Attio](/pt/articles/16815852-configure-attio#:~:text=calls%20to%20Attio.-,Setting%20up%20a%20call%20object%20in%20Attio,-If%20you%20selected) do guia Configurar o Attio.

Depois de configurado, as chamadas aparecem como registos com todos os atributos mapeados preenchidos:

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/ede14e6a7e3c-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=3ad1acf215896704a4c724fc1bb98563" alt="" width="350" data-path="images/help-center/articles/16815902/ede14e6a7e3c-image.png" />
</Frame>

Em cada registo de pessoa no Attio aparece também um separador **CloudTalk call**, que lhe dá acesso rápido ao histórico de chamadas do contacto:

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/eb20731386bb-screenshot-2026-09-04-at-10-08-04.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=aea32b817f566a416f3cb98e82beb1be" alt="" width="2027" height="450" data-path="images/help-center/articles/16815902/eb20731386bb-screenshot-2026-09-04-at-10-08-04.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/f12fc8fb89f1-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=74ae90786458254604884fc93435a723" alt="" width="350" data-path="images/help-center/articles/16815902/f12fc8fb89f1-image.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/cloudtalk/8FCfL6QWpEnHvO8c/images/help-center/articles/16815902/429974dd78c5-image.png?fit=max&auto=format&n=8FCfL6QWpEnHvO8c&q=85&s=b953ef55bfabeb8af4f2effc53e140e1" alt="" width="1570" height="524" data-path="images/help-center/articles/16815902/429974dd78c5-image.png" />
</Frame>

<h3 id="h_6160664685">
  Mapeamento de campos de chamada (objeto personalizado)
</h3>

Ao utilizar um objeto de chamada personalizado, estão disponíveis os seguintes campos para mapeamento:

| **Campo da CloudTalk** | **O que é** |
| - | - |
| Call ID | O identificador da chamada na CloudTalk |
| Call Started At / Call Ended At | Quando a chamada começou e quando terminou |
| Direction | Chamada de entrada ou de saída |
| Disposition | Como a chamada terminou |
| Duration / Wait Time | Duração da chamada e tempo de espera |
| Recording URL | Ligação para a gravação |
| From number | O número de onde partiu a chamada |
| Agent Email / Agent Name | O agente que tratou a chamada |
| AI Summary | Resumo da chamada gerado por IA |
| AI Sentiment | Sentimento geral da conversa |
| AI Topics | Tópicos detetados na conversa |
| Call Details URL | Ligação para os detalhes completos da chamada na CloudTalk |
| Call Tags | Etiquetas aplicadas à chamada |
| Call Notes | Notas que os seus agentes adicionaram à chamada |

<h3 id="h_f7665a5ed4">
  Atribuir chamadas aos agentes
</h3>

Adicione um atributo **Actor reference** ao seu objeto de chamada e mapeie-o para **Agent Email**. A CloudTalk faz a correspondência entre o agente e um membro do seu workspace do Attio através do email, para que as chamadas sejam atribuídas à pessoa certa e possa filtrar ou agrupar por ela.

<Tip>
  **Nota:** O agente tem de ser membro do seu workspace do Attio com o mesmo email que utiliza na CloudTalk.
</Tip>

<h2 id="h_a9abc0326f">
  Etiquetas de chamada, notas e dados de IA
</h2>

As etiquetas, as notas e os dados de IA (resumo, sentimento, tópicos) chegam normalmente depois de a chamada terminar. O local onde aparecem depende do seu mapeamento:

* **Mapeados**: São escritos nos atributos do Attio que escolheu. Podem ser filtrados, agrupados e utilizados em automações.

* **Não mapeados**: A CloudTalk anexa ao registo da chamada uma nota apenas com essa informação, para que nada se perca. Uma atualização de etiquetas gera uma nota de etiquetas e os dados de IA geram uma nota de IA.

<h2 id="h_fbb5ffaa91">
  Registo de SMS
</h2>

Com o registo de SMS ativado, cada mensagem é registada como uma nota no registo de pessoa do contacto, com um título que indica a direção (SMS Sent / SMS Received) e com o texto da mensagem.

***

*Precisa de ajuda ou tem alguma questão?* Contacte-nos através do nosso [Portal de Suporte](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Configurar o Attio](/pt/articles/16815852-configure-attio.md)
- [Utilizar a CloudTalk com o monday.com](/pt/articles/11600475-using-cloudtalk-with-monday-com.md)
- [Utilizar o Workable com a CloudTalk](/pt/articles/11792909-using-workable-with-cloudtalk.md)


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