Automação Klaviyo via Rube MCP

Automatize operações de marketing por e-mail e SMS do Klaviyo através do kit de ferramentas Klaviyo da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (ferramentas RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa com o Klaviyo via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas klaviyo
• 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 sua configuração de 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 klaviyo
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a autenticação do Klaviyo
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Listar e Filtrar Campanhas

Quando usar: O usuário deseja navegar, pesquisar ou filtrar campanhas de marketing

Sequência de ferramentas:

1. KLAVIYO_GET_CAMPAIGNS - Listar campanhas com filtros de canal e status [Obrigatório]

Parâmetros chave:

• channel: Canal da campanha — 'email' ou 'sms' (exigido pela API do Klaviyo)
• filter: String de filtro adicional (por exemplo, equals(status,"draft"))
• sort: Campo de ordenação com prefixo - opcional para decrescente (por exemplo, '-created_at', 'name')
• page_cursor: Cursor de paginação para a próxima página
• include_archived: Incluir campanhas arquivadas (padrão: false)

Armadilhas:

• channel é obrigatório; omiti-lo pode produzir resultados incompletos ou inesperados
• A paginação é obrigatória para cobertura completa; uma única chamada retorna apenas uma página (padrão ~10)
• Siga page_cursor até esgotar para obter todas as campanhas
• A filtragem de status via filter (por exemplo, equals(status,"draft")) pode retornar status mistos; sempre valide data[].attributes.status no lado do cliente
• As strings de status diferenciam maiúsculas de minúsculas e podem ser compostas (por exemplo, 'Cancelled: No Recipients')
• A forma da resposta é aninhada: response.data.data com status em data[].attributes.status

2. Obter Detalhes da Campanha

Quando usar: O usuário deseja informações detalhadas sobre uma campanha específica

Sequência de ferramentas:

1. KLAVIYO_GET_CAMPAIGNS - Encontrar campanha para obter seu ID [Pré-requisito]
2. KLAVIYO_GET_CAMPAIGN - Recuperar detalhes completos da campanha [Obrigatório]

Parâmetros chave:

• campaign_id: String do ID da campanha (por exemplo, '01GDDKASAP8TKDDA2GRZDSVP4H')
• include_messages: Incluir mensagens da campanha na resposta
• include_tags: Incluir tags na resposta

Armadilhas:

• Os IDs de campanha são strings alfanuméricas, não numéricas
• include_messages e include_tags adicionam dados relacionados à resposta através do mecanismo de inclusão do Klaviyo
• Os detalhes da campanha incluem públicos, estratégia de envio, opções de rastreamento e informações de agendamento

3. Inspecionar Mensagens de Campanha

Quando usar: O usuário deseja visualizar o conteúdo de e-mail/SMS de uma campanha

Sequência de ferramentas:

1. KLAVIYO_GET_CAMPAIGN - Encontrar campanha e seus IDs de mensagem [Pré-requisito]
2. KLAVIYO_GET_CAMPAIGN_MESSAGE - Obter detalhes do conteúdo da mensagem [Obrigatório]

Parâmetros chave:

• id: String do ID da mensagem
• fields__campaign__message: Conjunto de campos esparsos para atributos da mensagem (por exemplo, 'content.subject', 'content.from_email', 'content.body')
• fields__campaign: Conjunto de campos esparsos para atributos da campanha
• fields__template: Conjunto de campos esparsos para atributos do modelo
• include: Recursos relacionados a serem incluídos ('campaign', 'template')

Armadilhas:

• Os IDs de mensagem são separados dos IDs de campanha; extraia da resposta da campanha
• A sintaxe do conjunto de campos esparsos usa notação de ponto para campos aninhados: 'content.subject', 'content.from_email'
• Mensagens de e-mail têm campos de conteúdo: subject, preview_text, from_email, from_label, reply_to_email
• Mensagens SMS têm campos de conteúdo: body
• Incluir 'template' fornece o conteúdo HTML/texto do e-mail

4. Gerenciar Tags de Campanha

Quando usar: O usuário deseja visualizar tags associadas a campanhas para organização

Sequência de ferramentas:

1. KLAVIYO_GET_CAMPAIGN_RELATIONSHIPS_TAGS - Obter IDs de tag para uma campanha [Obrigatório]

Parâmetros chave:

• id: String do ID da campanha

Armadilhas:

• Retorna apenas IDs de tag, não nomes/detalhes de tag
• Os IDs de tag podem ser usados com os endpoints de tag do Klaviyo para detalhes completos
• Limite de taxa: rajada de 3/s, constante de 60/m (mais rigoroso que outros endpoints)

5. Monitorar Jobs de Envio de Campanha

Quando usar: O usuário deseja verificar o status de uma operação de envio de campanha

Sequência de ferramentas:

1. KLAVIYO_GET_CAMPAIGN_SEND_JOB - Verificar status do job de envio [Obrigatório]

Parâmetros chave:

…