Automação Attio

Gerencie seu espaço de trabalho do Attio CRM -- pesquise de forma aproximada pessoas e empresas, execute consultas filtradas complexas, navegue por notas, descubra esquemas de objetos e liste registros -- tudo através de comandos em linguagem natural.

Documentação do Toolkit: composio.dev/toolkits/attio

Configuração

1. Adicione o servidor Composio MCP à 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 Aproximada em Registros

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

Ferramenta: ATTIO_SEARCH_RECORDS

Exemplo de prompt:

"Pesquisar no Attio por qualquer pessoa chamada Alan Mathis"

Parâmetros principais (todos obrigatórios):

• query -- String de pesquisa (máximo de 256 caracteres). String vazia retorna resultados padrão.
• objects -- Array de slugs de objetos para pesquisar (por exemplo, ["people"], ["people", "companies"], ["deals"])
• request_as -- Contexto: use {"type": "workspace"} para pesquisa completa no espaço de trabalho ou especifique um membro do espaço de trabalho

2. Consultas Filtradas Avançadas

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

Ferramenta: ATTIO_QUERY_RECORDS

Exemplo de prompt:

"Encontrar 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 (por exemplo, "people", "companies", "deals")
• filter -- Objeto de filtro Attio com operadores como $eq, $contains, $gte, $and, $or
• sorts -- Array de especificações de ordenação com direction ("asc"/"desc") e attribute
• limit -- Número máximo de registros a retornar (até 500)
• offset -- Offset de paginação

Exemplos de filtro:

{"name": {"first_name": {"$contains": "John"}}}
{"email_addresses": {"$contains": "@example.com"}}
{"created_at": {"$gte": "2025-01-01T00:00:00.000Z"}}

3. Encontrar Registros por ID ou Atributos

Procure um registro específico por seu ID exclusivo ou pesquise por valores de atributos exclusivos.

Ferramenta: ATTIO_FIND_RECORD

Exemplo de prompt:

"Encontrar a empresa Attio com o domínio example.com"

Parâmetros principais:

• object_id (obrigatório) -- Slug do tipo de objeto: "people", "companies", "deals", "users", "workspaces"
• record_id -- Pesquisa direta por UUID (opcional)
• attributes -- Dicionário de filtros de atributos (por exemplo, {"email_addresses": "john@example.com"})
• limit -- Número máximo de registros (até 1000)
• offset -- Offset de paginação

4. Navegar e Filtrar Notas

Liste notas em todo o espaço de trabalho ou filtre por objetos pais e registros específicos.

Ferramenta: ATTIO_LIST_NOTES

Exemplo de prompt:

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

Parâmetros principais:

• parent_object -- Slug do objeto (por exemplo, "people", "companies", "deals") -- requer parent_record_id
• parent_record_id -- UUID do registro pai -- requer parent_object
• limit -- Número máximo de notas a retornar (1-50, padrão 10)
• offset -- Número de resultados a pular

5. Descobrir Esquemas e Atributos de Objetos

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

Ferramentas: ATTIO_GET_OBJECT, ATTIO_LIST_ATTRIBUTES

Exemplo de prompt:

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

Parâmetros principais para Obter Objeto:

• object_id -- Slug ou UUID do objeto

Parâmetros principais para Listar Atributos:

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

6. Listar Todos os Registros

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

Ferramenta: ATTIO_LIST_RECORDS

Exemplo de prompt:

"Listar os primeiros 100 registros de pessoas no Attio"

Parâmetros principais:

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

Armadilhas Conhecidas

• Formato de timestamp é crítico: TODAS as comparações de timestamp (created_at, updated_at, timestamps personalizados) DEVEM usar o formato de string ISO8601 (por exemplo, 2025-01-01T00:00:00.000Z). Timestamps Unix ou valores numéricos causam erros de "Valor de timestamp inválido".
• Atributos de nome devem ser aninhados: O atributo name tem subpropriedades (first_name, last_name, full_name) que DEVEM ser aninhadas sob name. Correto: {"name": {"first_name": {"$contains": "John"}}}. Errado: {"first_name": {...}} -- isso falha com "unknown_filter_attribute_slug".

…