Automação Postmark via Rube MCP

Automatize operações de e-mail transacional do Postmark através do toolkit Postmark da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa com Postmark via RUBE_MANAGE_CONNECTIONS com o toolkit postmark
• 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 postmark
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar a autenticação do Postmark
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Enviar E-mails em Lote com Template

Quando usar: O usuário deseja enviar e-mails com template para múltiplos destinatários em uma única chamada

Sequência de ferramentas:

1. POSTMARK_LIST_TEMPLATES - Encontre templates disponíveis e seus IDs [Pré-requisito]
2. POSTMARK_VALIDATE_TEMPLATE - Valide o template com dados do modelo antes de enviar [Opcional]
3. POSTMARK_SEND_BATCH_WITH_TEMPLATES - Envie e-mails em lote usando um template [Obrigatório]

Parâmetros chave:

• TemplateId ou TemplateAlias: Identificador para o template a ser usado
• Messages: Array de objetos de mensagem com From, To, TemplateModel
• TemplateModel: Pares de chave-valor que correspondem às variáveis do template

Armadilhas:

• Máximo de 500 mensagens por chamada em lote
• TemplateId ou TemplateAlias é necessário, não ambos
• As chaves de TemplateModel devem corresponder exatamente aos nomes das variáveis do template (sensível a maiúsculas e minúsculas)
• O endereço do remetente deve ser uma Assinatura de Remetente verificada ou de um domínio verificado

2. Gerenciar Templates de E-mail

Quando usar: O usuário deseja criar, editar ou inspecionar templates de e-mail

Sequência de ferramentas:

1. POSTMARK_LIST_TEMPLATES - Liste todos os templates com IDs e nomes [Obrigatório]
2. POSTMARK_GET_TEMPLATE - Obtenha detalhes completos do template, incluindo corpo HTML/texto [Opcional]
3. POSTMARK_EDIT_TEMPLATE - Atualize o conteúdo ou as configurações do template [Opcional]
4. POSTMARK_VALIDATE_TEMPLATE - Teste a renderização do template com dados de exemplo [Opcional]

Parâmetros chave:

• TemplateId: ID numérico do template para operações GET/EDIT
• Name: Nome de exibição do template
• Subject: Linha de assunto do e-mail (suporta variáveis de template)
• HtmlBody: Conteúdo HTML do template
• TextBody: Conteúdo de fallback em texto simples
• TemplateType: 'Standard' ou 'Layout'

Armadilhas:

• IDs de template são inteiros numéricos, não strings
• Editar um template substitui todo o conteúdo; inclua todos os campos que você deseja manter
• Templates de Layout envolvem templates Standard; alterar um layout afeta todos os templates vinculados
• Valide antes de enviar para capturar variáveis ausentes precocemente

3. Monitorar Estatísticas de Entrega

Quando usar: O usuário deseja verificar a saúde da entrega de e-mail, taxas de abertura/clique ou visão geral de saída

Sequência de ferramentas:

1. POSTMARK_GET_DELIVERY_STATS - Obtenha contagens de bounces por tipo [Obrigatório]
2. POSTMARK_GET_OUTBOUND_OVERVIEW - Obtenha um resumo de enviados/abertos/clicados/com bounce [Obrigatório]
3. POSTMARK_GET_TRACKED_EMAIL_COUNTS - Obtenha o volume de e-mails rastreados ao longo do tempo [Opcional]

Parâmetros chave:

• fromdate: Data de início para filtrar estatísticas (AAAA-MM-DD)
• todate: Data de fim para filtrar estatísticas (AAAA-MM-DD)
• tag: Filtre estatísticas por tag de mensagem
• messagestreamid: Filtre por stream de mensagens (por exemplo, 'outbound', 'broadcast')

Armadilhas:

• Parâmetros de data usam o formato AAAA-MM-DD sem componente de hora
• Estatísticas são agregadas; o rastreamento de mensagens individuais requer chamadas de API separadas
• messagestreamid usa o padrão para todos os streams se não for especificado

4. Gerenciar Bounces e Reclamações

Quando usar: O usuário deseja revisar e-mails com bounce ou reclamações de spam

Sequência de ferramentas:

1. POSTMARK_GET_BOUNCES - Liste mensagens com bounce com detalhes [Obrigatório]
2. POSTMARK_GET_SPAM_COMPLAINTS - Liste registros de reclamações de spam [Opcional]
3. POSTMARK_GET_DELIVERY_STATS - Obtenha contagens de resumo de bounce [Opcional]

Parâmetros chave:

• count: Número de registros a serem retornados por página
• offset: Offset de paginação para resultados
• type: Filtro de tipo de bounce (por exemplo, 'HardBounce', 'SoftBounce', 'SpamNotification')
• fromdate/todate: Filtros de intervalo de datas
• emailFilter: Filtre por endereço de e-mail do destinatário

Armadilhas:

• Tipos de bounce incluem: HardBounce, SoftBounce, SpamNotification, SpamComplaint, Transient e outros

…