Automação do SendGrid via Rube MCP

Automatize fluxos de entrega de e-mail do SendGrid, incluindo campanhas de marketing (Envios Únicos), gerenciamento de contatos e listas, configuração de identidade do remetente e análise de e-mail através do kit de ferramentas SendGrid da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o SendGrid via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas sendgrid
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter 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 kit de ferramentas sendgrid
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação da chave de API do SendGrid
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar e Enviar Campanhas de Marketing (Envios Únicos)

Quando usar: O usuário deseja criar e enviar uma campanha de e-mail marketing para uma lista de contatos ou segmento.

Sequência de ferramentas:

1. SENDGRID_RETRIEVE_ALL_LISTS - Lista as listas de marketing disponíveis para segmentação [Pré-requisito]
2. SENDGRID_CREATE_A_LIST - Cria uma nova lista, se necessário [Opcional]
3. SENDGRID_ADD_OR_UPDATE_A_CONTACT - Adiciona contatos à lista [Opcional]
4. SENDGRID_GET_ALL_SENDER_IDENTITIES - Obtém o ID do remetente verificado [Pré-requisito]
5. SENDGRID_CREATE_SINGLE_SEND - Cria a campanha com conteúdo, remetente e destinatários [Obrigatório]

Parâmetros chave para SENDGRID_CREATE_SINGLE_SEND:

• name: Nome da campanha (obrigatório)
• email__config__subject: Assunto do e-mail
• email__config__html__content: Conteúdo do corpo em HTML
• email__config__plain__content: Versão em texto puro
• email__config__sender__id: ID da identidade do remetente verificado
• email__config__design__id: Use em vez de html_content para designs pré-construídos
• send__to__list__ids: Array de UUIDs de listas para enviar
• send__to__segment__ids: Array de UUIDs de segmentos
• send__to__all: true para enviar para todos os contatos
• email__config__suppression__group__id ou email__config__custom__unsubscribe__url: Um é necessário para conformidade

Armadilhas:

• Definir send_at em CREATE NÃO agenda o envio; ele apenas pré-preenche a data na interface do usuário; use o endpoint de Agendamento separadamente
• send_at: "now" é válido apenas com o endpoint de Agendamento, não com CREATE
• É preciso fornecer suppression_group_id ou custom_unsubscribe_url para conformidade de descadastramento
• O remetente deve ser verificado antes do uso; verifique com SENDGRID_GET_ALL_SENDER_IDENTITIES
• Parâmetros aninhados usam notação de duplo sublinhado (por exemplo, email__config__subject)

2. Gerenciar Contatos e Listas

Quando usar: O usuário deseja criar listas de contatos, adicionar/atualizar contatos, pesquisar contatos ou remover contatos de listas.

Sequência de ferramentas:

1. SENDGRID_RETRIEVE_ALL_LISTS - Lista todas as listas de marketing [Obrigatório]
2. SENDGRID_CREATE_A_LIST - Cria uma nova lista de contatos [Opcional]
3. SENDGRID_GET_A_LIST_BY_ID - Obtém detalhes da lista e contatos de exemplo [Opcional]
4. SENDGRID_ADD_OR_UPDATE_A_CONTACT - Adiciona ou atualiza contatos com associação à lista [Obrigatório]
5. SENDGRID_GET_CONTACTS_BY_EMAILS - Procura contatos por e-mail [Opcional]
6. SENDGRID_GET_CONTACTS_BY_IDENTIFIERS - Procura contatos por e-mail, telefone ou ID externo [Opcional]
7. SENDGRID_GET_LIST_CONTACT_COUNT - Verifica a contagem de contatos após as operações [Opcional]
8. SENDGRID_REMOVE_CONTACTS_FROM_A_LIST - Remove contatos de uma lista sem excluí-los [Opcional]
9. SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS - Exclui uma lista inteira [Opcional]
10. SENDGRID_IMPORT_CONTACTS - Importação em massa de CSV [Opcional]

Parâmetros chave para SENDGRID_ADD_OR_UPDATE_A_CONTACT:

• contacts: Array de objetos de contato (máximo 30.000 ou 6MB), cada um com pelo menos um identificador: email, phone_number_id, external_id ou anonymous_id (obrigatório)
• list_ids: Array de strings de UUIDs de listas para associar os contatos

Armadilhas:

• SENDGRID_ADD_OR_UPDATE_A_CONTACT é assíncrono; retorna 202 com job_id; os contatos podem levar de 10 a 30 segundos para aparecer
• IDs de lista são UUIDs (por exemplo, "ca7a3796-e8a8-4029-9ccb-df8937940562"), não inteiros
• Nomes de lista devem ser únicos; nomes duplicados causam erros 400
• SENDGRID_ADD_A_SINGLE_RECIPIENT_TO_A_LIST usa a API legada; prefira SENDGRID_ADD_OR_UPDATE_A_CONTACT com list_ids
• SENDGRID_REMOVE_LIST_AND_OPTIONAL_CONTACTS é irreversível; requer confirmação explícita do usuário

…