Automação Attio

O que Automação Attio faz?

Gerencie seu workspace do Attio CRM — pesquise de forma difusa pessoas e empresas, execute consultas complexas com filtros, navegue por notas, descubra esquemas de objetos e liste registros — tudo por meio de comandos em linguagem natural.

Documentação do kit de ferramentas: composio.dev/toolkits/attio

---

Configuração

1. Adicione o servidor MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta Attio quando solicitado (autenticação OAuth).
3. Comece a emitir comandos em linguagem natural para gerenciar seus dados de CRM.

---

Fluxos de Trabalho Principais

1. Pesquisa Difusa em Registros

Pesquise pessoas, empresas, negócios ou qualquer objeto por nome, domínio, e-mail, telefone ou perfil social.

Ferramenta: ATTIO_SEARCH_RECORDS

Exemplo de prompt:

"Pesquise no Attio por alguém chamado Alan Mathis"

Parâmetros principais (todos obrigatórios):

• query — String de pesquisa (máx. 256 caracteres). String vazia retorna resultados padrão.
• objects — Array de slugs de objetos a serem pesquisados (ex.: ["people"], ["people", "companies"], ["deals"])
• request_as — Contexto: use {"type": "workspace"} para pesquisa em todo o workspace, ou especifique um membro do workspace

---

2. Consultas com Filtros Avançados

Consulte registros com filtros, ordenação e condições complexas no lado do servidor — muito mais poderoso que a pesquisa difusa.

Ferramenta: ATTIO_QUERY_RECORDS

Exemplo de prompt:

"Encontre todas as empresas no Attio criadas após janeiro de 2025 ordenadas por nome"

Parâmetros principais:

• object (obrigatório) — Slug ou UUID do objeto (ex.: "people", "companies", "deals")
• filter — Objeto de filtro do Attio com operadores como $eq, $contains, $gte, $and, $or
• sorts — Array de especificações de ordenação com direction ("asc"/"desc") e attribute
• limit — Máx. de registros a retornar (até 500)
• offset — Deslocamento de paginação

Exemplos de filtro:

{"name": {"first_name": {"$contains": "João"}}}
{"email_addresses": {"$contains": "@exemplo.com"}}
{"created_at": {"$gte": "2025-01-01T00:00:00.000Z"}}

---

3. Localizar Registros por ID ou Atributos

Consulte um registro específico pelo seu ID único ou pesquise por valores de atributos únicos.

Ferramenta: ATTIO_FIND_RECORD

Exemplo de prompt:

"Encontre a empresa no Attio com domínio exemplo.com"

Parâmetros principais:

• object_id (obrigatório) — Slug do tipo de objeto: "people", "companies", "deals", "users", "workspaces"
• record_id — Consulta direta por UUID (opcional)
• attributes — Dicionário de filtros de atributo (ex.: {"email_addresses": "[email protected]"})
• limit — Máx. de registros (até 1000)
• offset — Deslocamento de paginação

---

4. Navegar e Filtrar Notas

Liste notas em todo o workspace ou filtre por objetos e registros pai específicos.

Ferramenta: ATTIO_LIST_NOTES

Exemplo de prompt:

"Mostre as últimas 10 notas do registro da empresa Acme Corp no Attio"

Parâmetros principais:

• parent_object — Slug do objeto (ex.: "people", "companies", "deals") — requer parent_record_id
• parent_record_id — UUID do registro pai — requer parent_object
• limit — Máx. de notas a retornar (1-50, padrão 10)
• offset — Número de resultados a pular

---

5. Descobrir Esquemas de Objetos e Atributos

Entenda a estrutura do seu workspace listando objetos e suas definições de atributos.

Ferramentas: ATTIO_GET_OBJECT, ATTIO_LIST_ATTRIBUTES

Exemplo de prompt:

"Quais atributos o objeto de empresas possui no Attio?"

Parâmetros principais para Get Object:

• object_id — Slug ou UUID do objeto

Parâmetros principais para List Attributes:

• target — "objects" ou "lists"
• identifier — ID ou slug do objeto ou lista

---

6. Listar Todos os Registros

Recupere registros de um tipo de objeto específico com paginação simples, retornados na ordem de criação.

Ferramenta: ATTIO_LIST_RECORDS

Exemplo de prompt:

"Liste os primeiros 100 registros de pessoas no Attio"

Parâmetros principais:

• Identificador do tipo de objeto
• Parâmetros de paginação

---

Armadilhas Conhecidas

• O formato do timestamp é crítico: TODAS as comparações de timestamp (created_at, updated_at, timestamps personalizados) DEVEM usar o formato de string ISO8601 (ex.: 2025-01-01T00:00:00.000Z). Timestamps Unix ou valores numéricos causam erros "Invalid timestamp value".
• Atributos de nome devem estar aninhados: O atributo name possui subpropriedades (first_name, last_name, full_name) que DEVEM estar aninhadas sob name. Correto: {"name": {"first_name": {"$contains": "João"}}}. Incorreto: {"first_name": {...}} — isso falha com "unknown_filter_attribute_slug".
• Operadores de e-mail são limitados: email_addresses suporta $eq, $contains, $starts_with, $ends_with mas NÃO $not_empty.
• Atributos de referência a registros precisam de filtragem por caminho: Para atributos que referenciam outros registros (ex.: "team", "company"), use filtragem baseada em caminho, não sintaxe aninhada. Exemplo: {"path": [["companies", "team"], ["people", "name"]], "constraints": {"first_name": {"$eq": "João"}}}.
• "lists" não é um tipo de objeto: Não use "lists" como object_id. Use ações específicas de lista para operações em listas.
• Pesquisa tem consistência eventual: ATTIO_SEARCH_RECORDS retorna resultados com consistência eventual. Para resultados garantidamente atualizados, use ATTIO_QUERY_RECORDS.
• Slugs de atributos variam por workspace: Atributos de sistema (ex.: "email_addresses", "name") são consistentes, mas atributos personalizados variam. Use ATTIO_LIST_ATTRIBUTES para descobrir slugs válidos para seu workspace.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Pesquisar registros	ATTIO_SEARCH_RECORDS	query, objects, request_as
Consultar com filtros	ATTIO_QUERY_RECORDS	object
Localizar registro por ID/atributos	ATTIO_FIND_RECORD	object_id
Listar notas	ATTIO_LIST_NOTES	Nenhum (filtros opcionais)
Obter esquema do objeto	ATTIO_GET_OBJECT	object_id
Listar atributos	ATTIO_LIST_ATTRIBUTES	target, identifier
Listar registros	ATTIO_LIST_RECORDS	Tipo de objeto

---

Desenvolvido por Composio