Ir para a navegação

Attio

Reconheça pessoas que ligam, adicione novos contatos e registre notas de chamadas no Attio durante as ligações.

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 chamam a API do Attio diretamente, sem conta do Zapier nem uso de tarefas do Zapier.
  • As ações do 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)

1

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.

2

Crie as ferramentas de webhook

Para cada ferramenta abaixo, 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.

3

Adicione uma regra

Adicione uma regra 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

CampoValor
Nomefind_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étodoPOST
URLhttps://api.attio.com/v2/objects/people/records/query
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros do corpofilter (objeto, obrigatório), com o campo abaixo
limit (inteiro, valor fixo): 5
Atribuir a agentesRecepcionista

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

CampoValor
Nomecreate_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étodoPOST
URLhttps://api.attio.com/v2/objects/people/records
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros do corpodata (objeto, obrigatório), com os campos abaixo
Atribuir a agentesRecepcionista

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

CampoValor
Nomeadd_attio_note
Descrição”Registre o que quem está ligando queria no registro da pessoa antes de a chamada terminar.”
MétodoPOST
URLhttps://api.attio.com/v2/notes
Cabeçalhos da solicitaçãoAuthorization (Secret): Bearer seguido do seu token
Parâmetros do corpodata (objeto, obrigatório), com os campos abaixo
Atribuir a agentesRecepcionista

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.

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 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

1

Conecte o Zapier

Se ainda não fez isso, conecte o Zapier no Reception.ai.

2

Adicione as ações do Attio

No seu servidor MCP do Zapier em mcp.zapier.com, adicione as ações abaixo do app Attio e conecte seu workspace do Attio. Para cada campo, defina um valor fixo ou deixe a IA preenchê-lo, conforme listado.

3

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.

4

Adicione uma regra

Adicione uma regra informando à sua recepcionista que ela deve usar o Attio apenas para reconhecer quem liga e nunca ler registros ou notas para essas pessoas.

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.

5

Teste

Teste sua recepcionista 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

CampoValor
Ação do ZapierFind Records
Definir no ZapierO objeto: Pessoas. O atributo para pesquisar: número de telefone.
Deixar a IA preencherO valor a pesquisar: o número de telefone de quem está ligando.
Atribuir aCliente

Adicione quem está ligando

CampoValor
Ação do ZapierCreate Record
Definir no ZapierO objeto: Pessoas. Quaisquer atributos que devam ser sempre iguais, se você os usar.
Deixar a IA preencherNome, sobrenome, número de telefone e endereço de e-mail.
Atribuir aCliente

Registre uma nota

CampoValor
Ação do ZapierCreate Note
Definir no ZapierO objeto pai: Pessoas.
Deixar a IA preencherO ID do registro pai (das ações anteriores), um título e o texto da nota com o que quem está ligando precisa.
Atribuir aCliente

Independentemente da opção escolhida, adicione um procedimento 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

ProblemaO que verificar
401 ou 403 do AttioInicie 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.aiSelecione Atualizar ferramentas na integração do Zapier após adicionar ações no Zapier.
Uma ação mostra Alterada e não é usadaVocê a editou no Zapier. Selecione Atualizar na aba Ferramentas.
Pessoas conhecidas que ligam não são encontradasVerifique 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 falhaO 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á ligandoSua recepcionista precisa do ID do registro da ferramenta de encontrar ou criar, ou de Find Records ou Create Record no Zapier.