Automação do Intercom via Rube MCP

Automatize operações do Intercom através do toolkit Intercom do Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com o Intercom via RUBE_MANAGE_CONNECTIONS com o toolkit intercom
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit intercom
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Intercom
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Gerenciar Conversas

Quando usar: O usuário deseja criar, listar, pesquisar ou gerenciar conversas de suporte

Sequência de ferramentas:

1. INTERCOM_LIST_ALL_ADMINS - Obter IDs de administradores para atribuição [Pré-requisito]
2. INTERCOM_LIST_CONVERSATIONS - Listar todas as conversas [Opcional]
3. INTERCOM_SEARCH_CONVERSATIONS - Pesquisar com filtros [Opcional]
4. INTERCOM_GET_CONVERSATION - Obter detalhes da conversa [Opcional]
5. INTERCOM_CREATE_CONVERSATION - Criar uma nova conversa [Opcional]

Parâmetros-chave:

• from: Objeto com type ('user'/'lead') e id para o criador da conversa
• body: Corpo da mensagem (HTML suportado)
• id: ID da conversa para recuperação
• query: Objeto de consulta de pesquisa com field, operator, value

Armadilhas:

• CREATE_CONVERSATION requer um contato (usuário/lead) como o campo from, não um administrador
• Corpos de conversa suportam HTML; texto simples é automaticamente envolvido em tags <p>
• A consulta de pesquisa usa objetos de filtro estruturados, não pesquisa de texto livre
• IDs de conversa são strings numéricas

2. Responder e Gerenciar Estado da Conversa

Quando usar: O usuário deseja responder, fechar, reabrir ou atribuir conversas

Sequência de ferramentas:

1. INTERCOM_GET_CONVERSATION - Obter estado atual [Pré-requisito]
2. INTERCOM_REPLY_TO_CONVERSATION - Adicionar uma resposta [Opcional]
3. INTERCOM_ASSIGN_CONVERSATION - Atribuir a administrador/equipe [Opcional]
4. INTERCOM_CLOSE_CONVERSATION - Fechar conversa [Opcional]
5. INTERCOM_REOPEN_CONVERSATION - Reabrir conversa fechada [Opcional]

Parâmetros-chave:

• conversation_id / id: ID da conversa
• body: Corpo da mensagem de resposta (HTML suportado)
• type: Tipo de resposta ('admin' ou 'user')
• admin_id: ID do administrador para respostas de administrador, atribuição e fechar/reabrir
• assignee_id: ID do administrador ou equipe para atribuição
• message_type: 'comment' (padrão) ou 'note' (interna)

Armadilhas:

• admin_id é NECESSÁRIO para respostas de administrador, fechar, reabrir e operações de atribuição
• Sempre obtenha os IDs de administrador primeiro com LIST_ALL_ADMINS ou IDENTIFY_AN_ADMIN
• Envio duplicado pode ocorrer na retentativa; implemente verificações de idempotência
• Notas internas usam message_type: 'note'; visíveis apenas para membros do espaço de trabalho
• Fechar requer um admin_id e uma mensagem de corpo opcional

3. Gerenciar Contatos

Quando usar: O usuário deseja pesquisar, visualizar ou gerenciar contatos (usuários e leads)

Sequência de ferramentas:

1. INTERCOM_SEARCH_CONTACTS - Pesquisar contatos com filtros [Obrigatório]
2. INTERCOM_GET_A_CONTACT - Obter contato específico [Opcional]
3. INTERCOM_SHOW_CONTACT_BY_EXTERNAL_ID - Consultar por ID externo [Opcional]
4. INTERCOM_LIST_CONTACTS - Listar todos os contatos [Opcional]
5. INTERCOM_LIST_TAGS_ATTACHED_TO_A_CONTACT - Obter tags de contato [Opcional]
6. INTERCOM_LIST_ATTACHED_SEGMENTS_FOR_CONTACT - Obter segmentos de contato [Opcional]
7. INTERCOM_DETACH_A_CONTACT - Remover contato da empresa [Opcional]

Parâmetros-chave:

• contact_id: ID do contato para recuperação
• external_id: ID do sistema externo para consulta
• query: Objeto de filtro de pesquisa com field, operator, value
• pagination: Objeto com cursor per_page e starting_after

Armadilhas:

• SEARCH_CONTACTS usa filtros de consulta estruturados, não texto livre; formato: {field, operator, value}
• Operadores suportados: =, !=, >, <, ~ (contém), !~ (não contém), IN, NIN
• Tipos de contato são 'user' (identificado) ou 'lead' (anônimo)
• LIST_CONTACTS retorna resultados paginados; use o cursor starting_after para paginação
• IDs externos diferenciam maiúsculas de minúsculas

4. Gerenciar Administradores e Equipes

Quando usar: O usuário deseja listar administradores do espaço de trabalho ou identificar administradores específicos

Sequência de ferramentas:

1. INTERCOM_LIST_ALL_ADMINS - Listar todos os administradores e equipes [Obrigatório]

…