> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio Sua recepcionista pode reconhecer pessoas que ligam e já estão no Attio, adicionar novas pessoas como contatos com nome e número de telefone e deixar uma nota sobre o que elas queriam, para que sua equipe possa fazer o acompanhamento. Há duas formas de conectar: * As **[ferramentas de webhook](#option-1-webhook-tools-recommended)** chamam a API do Attio diretamente, sem conta do Zapier nem uso de tarefas do Zapier. * As ações do **[Zapier](#option-2-zapier)** fazem login no Attio para você, mas cada ação usa tarefas do seu plano do Zapier. Use ferramentas de webhook, a menos que você não consiga que um administrador do Attio crie um token de acesso. ## Opção 1: Ferramentas de webhook (recomendado) ### Crie um token de acesso Você precisa ser administrador do Attio. Selecione o menu suspenso ao lado do nome do seu workspace, abra **Configurações do workspace**, vá para a aba **Desenvolvedores** e selecione **Novo token de acesso**. Dê um nome a ele, por exemplo, `Reception.ai`, e conceda apenas os escopos de que essas ferramentas precisam: leitura de configuração de objeto (`object_configuration:read`), leitura e gravação de registros (`record_permission:read-write`) e leitura e gravação de notas (`note:read-write`). Os rótulos no Attio podem ser um pouco diferentes desses nomes. O token não expira e pode ver todas as pessoas no seu workspace. Exclua-o no Attio caso ele seja vazado. ### Crie as ferramentas de webhook Para cada [ferramenta abaixo](#find-the-caller), vá para **Integrações**, selecione **Adicionar integração** e escolha **Ferramenta de webhook**. Todas as ferramentas enviam o mesmo cabeçalho: `Authorization` (Secret), definido como `Bearer ` seguido do seu token. ### Adicione uma regra Adicione uma [regra](/docs/pt/reception-ai/receptionist/rules-and-procedures) informando à sua recepcionista que ela deve usar o Attio apenas para reconhecer quem liga e nunca ler registros ou notas para essas pessoas. ### Encontre quem está ligando | Campo | Valor | | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `find_attio_person` | | **Descrição** | "Encontre quem está ligando entre nossas pessoas no Attio pelo número de telefone. Use esta ferramenta no início de uma chamada. Passe o record_id da pessoa para a ferramenta de notas." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Cabeçalhos da solicitação** | `Authorization` (Secret): `Bearer ` seguido do seu token | | **Parâmetros do corpo** | `filter` (objeto, obrigatório), com o campo abaixo `limit` (inteiro, valor fixo): `5` | | **Atribuir a agentes** | **Recepcionista** | Selecione **Adicionar campo** em `filter` e adicione: * `phone_numbers` (string, obrigatório, da conversa): "O número de telefone de quem está ligando em formato internacional, por exemplo, +14155550123." O Attio retorna apenas pessoas cujo número salvo corresponde exatamente, portanto armazene os números com o código do país. ### Adicione quem está ligando | Campo | Valor | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_attio_person` | | **Descrição** | "Adicione quem está ligando como pessoa somente quando `find_attio_person` não a encontrar. Passe o record_id da nova pessoa para a ferramenta de notas." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Cabeçalhos da solicitação** | `Authorization` (Secret): `Bearer ` seguido do seu token | | **Parâmetros do corpo** | `data` (objeto, obrigatório), com os campos abaixo | | **Atribuir a agentes** | **Recepcionista** | Selecione **Adicionar campo** em `data` e adicione `values` (objeto, obrigatório). Em `values`, adicione: * `name` (objeto, obrigatório), com três campos: * `first_name` (string, obrigatório, da conversa): "O primeiro nome de quem está ligando." * `last_name` (string, obrigatório, da conversa): "O sobrenome de quem está ligando ou uma string vazia se não o informou." * `full_name` (string, obrigatório, da conversa): "O nome e o sobrenome de quem está ligando." * `phone_numbers` (array, obrigatório, da conversa): "Exatamente um item, para o número de telefone de quem está ligando." Em **Cada item**, escolha `string`, descrito como "O número de telefone de quem está ligando em formato internacional, por exemplo, +14155550123." * `email_addresses` (array, da conversa): "Exatamente um item, para o endereço de e-mail de quem está ligando. Deixe de fora se ela não fornecer um." Em **Cada item**, escolha `string`, descrito como "O endereço de e-mail de quem está ligando." ### Registre uma nota | Campo | Valor | | ----------------------------- | -------------------------------------------------------------------------------------------- | | **Nome** | `add_attio_note` | | **Descrição** | "Registre o que quem está ligando queria no registro da pessoa antes de a chamada terminar." | | **Método** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Cabeçalhos da solicitação** | `Authorization` (Secret): `Bearer ` seguido do seu token | | **Parâmetros do corpo** | `data` (objeto, obrigatório), com os campos abaixo | | **Atribuir a agentes** | **Recepcionista** | Selecione **Adicionar campo** em `data` para cada um destes: * `parent_object` (string, valor fixo): `people` * `parent_record_id` (string, obrigatório, da conversa): "O record_id da pessoa retornado por `find_attio_person` ou `create_attio_person`." * `title` (string, obrigatório, da conversa): "Um título curto, por exemplo: Chamada de Jane Doe sobre um orçamento." * `format` (string, valor fixo): `plaintext` * `content` (string, obrigatório, da conversa): "O que quem está ligando queria, em algumas frases." O objeto pai e o formato são valores fixos, então as notas sempre são adicionadas a uma pessoa, mesmo que a IA envie outros valores. > **Warning** > > `find_attio_person` retorna tudo o que está salvo na pessoa. Mantenha a regra ativa para que sua > recepcionista use o Attio apenas para reconhecer quem está ligando e para que essas pessoas nunca ouçam > detalhes de outra pessoa. Selecione **Ativar** em cada ferramenta e depois [teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma chamada de um número salvo em uma pessoa do Attio e, em seguida, como uma nova pessoa que pede retorno de chamada. A nova pessoa e uma nota aparecerão no Attio. ## Opção 2: Zapier ### Conecte o Zapier Se ainda não fez isso, conecte o [Zapier](/docs/pt/reception-ai/integrations/zapier) no Reception.ai. ### Adicione as ações do Attio No seu servidor MCP do Zapier em [mcp.zapier.com](https://mcp.zapier.com), adicione as [ações abaixo](#zapier-actions) do app **Attio** e conecte seu workspace do Attio. Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme listado. ### Atribua as ferramentas No Reception.ai, abra a aba **Ferramentas** da integração do Zapier, selecione **Atualizar ferramentas** e atribua cada ação conforme listado. ### Adicione uma regra Adicione uma [regra](/docs/pt/reception-ai/receptionist/rules-and-procedures) informando à sua recepcionista que ela deve usar o Attio apenas para reconhecer quem liga e nunca ler registros ou notas para essas pessoas. > **Warning** > > O Zapier atua como o usuário do Attio que conectou o workspace e pode ver tudo o que esse usuário pode ver. > Conecte usando um membro cujo acesso esteja limitado aos registros de que sua recepcionista precisa e mantenha a > regra ativa para que as pessoas que ligam nunca ouçam detalhes de outra pessoa. ### Teste [Teste sua recepcionista](/docs/pt/reception-ai/receptionist/testing) com uma chamada de um número salvo em uma pessoa do Attio e, em seguida, como uma nova pessoa que pede retorno de chamada. A nova pessoa e uma nota aparecerão no Attio. ### Ações do Zapier #### Encontre quem está ligando | Campo | Valor | | ------------------------- | ----------------------------------------------------------------- | | **Ação do Zapier** | **Find Records** | | **Definir no Zapier** | O objeto: Pessoas. O atributo para pesquisar: número de telefone. | | **Deixar a IA preencher** | O valor a pesquisar: o número de telefone de quem está ligando. | | **Atribuir a** | **Cliente** | #### Adicione quem está ligando | Campo | Valor | | ------------------------- | ------------------------------------------------------------------------------------ | | **Ação do Zapier** | **Create Record** | | **Definir no Zapier** | O objeto: Pessoas. Quaisquer atributos que devam ser sempre iguais, se você os usar. | | **Deixar a IA preencher** | Nome, sobrenome, número de telefone e endereço de e-mail. | | **Atribuir a** | **Cliente** | #### Registre uma nota | Campo | Valor | | ------------------------- | ------------------------------------------------------------------------------------------------------------- | | **Ação do Zapier** | **Create Note** | | **Definir no Zapier** | O objeto pai: Pessoas. | | **Deixar a IA preencher** | O ID do registro pai (das ações anteriores), um título e o texto da nota com o que quem está ligando precisa. | | **Atribuir a** | **Cliente** | > **Tip** > > Independentemente da opção escolhida, adicione um [procedimento](/docs/pt/reception-ai/receptionist/rules-and-procedures) > para que sua recepcionista procure primeiro por quem está ligando, crie uma pessoa apenas quando nenhuma correspondência for encontrada > e depois registre uma nota. ## Limitações * O Attio verifica se os números de telefone são válidos. Informe à sua recepcionista, na descrição da ferramenta ou ação, que envie os números em formato internacional, como `+14155550123`. * A criação de uma pessoa falha quando outra pessoa já tem o mesmo valor exclusivo, como um endereço de e-mail. Sua recepcionista deve pesquisar primeiro. * As tarefas criadas pelo Zapier não podem ser vinculadas a um registro do Attio, então use a nota para os detalhes da chamada. * Com o Zapier, cada ação executada pela sua recepcionista usa tarefas do seu plano do Zapier. Atualmente, o Zapier conta duas tarefas por chamada bem-sucedida; chamadas com falha não são contabilizadas. Quando o plano acaba, as ações param até que ele seja redefinido. ## Solução de problemas | Problema | O que verificar | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 ou 403 do Attio | Inicie o valor do cabeçalho com `Bearer ` e um espaço e verifique se o token tem os escopos acima e não foi excluído. | | Uma ação do Attio não aparece no Reception.ai | Selecione **Atualizar ferramentas** na integração do Zapier após adicionar ações no Zapier. | | Uma ação mostra **Alterada** e não é usada | Você a editou no Zapier. Selecione **Atualizar** na aba **Ferramentas**. | | Pessoas conhecidas que ligam não são encontradas | Verifique se os números estão armazenados com o código do país. Com o Zapier, verifique se **Find Records** pesquisa o objeto Pessoas pelo número de telefone. | | A criação de uma pessoa falha | O número de telefone pode não estar no formato internacional ou o endereço de e-mail de quem está ligando já está salvo. | | As notas não estão vinculadas a quem está ligando | Sua recepcionista precisa do ID do registro da ferramenta de encontrar ou criar, ou de **Find Records** ou **Create Record** no Zapier. |