O que Automação Customer.io faz?
Automatize operações de engajamento do cliente — dispare broadcasts direcionados, recupere métricas de entrega, gerencie segmentos de audiência, liste newsletters e templates transacionais, e inspecione o histórico de execução de triggers — tudo orquestrado através da integração MCP do Composio.
Documentação do toolkit: composio.dev/toolkits/customerio
Configuração
- Conecte sua conta do Customer.io através do servidor MCP do Composio em
https://rube.app/mcp - O agente solicitará um link de autenticação se nenhuma conexão ativa existir
- Uma vez conectado, todas as ferramentas
CUSTOMERIO_*ficam disponíveis para execução
Fluxos de Trabalho Principais
1. Disparar um Broadcast
Dispara manualmente um broadcast pré-configurado para uma audiência específica com dados de personalização.
Ferramenta: CUSTOMERIO_TRIGGER_BROADCAST
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
broadcast_id | integer | Sim | ID do broadcast conforme Detalhes de Disparo do Customer.io |
ids | array | Não | Lista de IDs de clientes a segmentar |
emails | array | Não | Lista de endereços de e-mail a segmentar |
recipients | object | Não | Filtro complexo com operadores and/or/not/segment |
per_user_data | array | Não | Personalização por usuário com id/email + data |
data | object | Não | Dados chave-valor globais para personalização de template Liquid |
data_file_url | string | Não | URL para arquivo JSON com dados de usuário por linha |
email_add_duplicates | boolean | Não | Permitir destinatários duplicados (padrão: false) |
email_ignore_missing | boolean | Não | Pular pessoas sem e-mail (padrão: false) |
id_ignore_missing | boolean | Não | Pular pessoas sem IDs de cliente (padrão: false) |
Importante: Forneça EXATAMENTE UMA opção de audiência: recipients, ids, emails, per_user_data ou data_file_url. Limite de taxa: 1 requisição a cada 10 segundos por broadcast.
2. Recuperar Métricas de Entrega de Mensagens
Busque métricas de entrega paginadas para mensagens com filtros por campanha, tipo e janela de tempo.
Ferramenta: CUSTOMERIO_GET_MESSAGES
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | string | Não | Tipo de mensagem: email, webhook, twilio, slack, push, in_app |
metric | string | Não | Métrica: attempted, sent, delivered, opened, clicked, converted |
campaign_id | integer | Não | Filtrar por ID da campanha |
newsletter_id | integer | Não | Filtrar por ID da newsletter |
action_id | integer | Não | Filtrar por ID da ação |
start_ts | integer | Não | Início da janela de tempo (timestamp Unix) |
end_ts | integer | Não | Fim da janela de tempo (timestamp Unix) |
limit | integer | Não | Resultados por página, 1-1000 (padrão: 50) |
start | string | Não | Token de paginação do valor next da resposta anterior |
drafts | boolean | Não | Retornar mensagens rascunho em vez de ativas/enviadas |
3. Listar Segmentos de Audiência
Recupere todos os segmentos definidos em seu workspace para análise de audiência e direcionamento de broadcast.
Ferramenta: CUSTOMERIO_GET_SEGMENTS
Nenhum parâmetro necessário — retorna todos os segmentos com IDs e metadados.
Use os IDs dos segmentos ao direcionar broadcasts através do filtro recipients.segment.id.
4. Listar Newsletters
Pagina através de todos os metadados de newsletter para rastreamento e análise.
Ferramenta: CUSTOMERIO_LIST_NEWSLETTERS
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit | integer | Não | Máx. por página, 1-100 |
sort | string | Não | asc (cronológico) ou desc (reverso) |
start | string | Não | Cursor de paginação do valor next da resposta anterior |
5. Descobrir Templates de Mensagens Transacionais
Liste todos os templates de mensagens transacionais para encontrar IDs para envio via API.
Ferramenta: CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES
Nenhum parâmetro necessário — retorna IDs de template e nomes de trigger.
6. Inspecionar Histórico de Disparo de Broadcast
Revise todas as execuções de trigger para um broadcast e inspecione detalhes de triggers individuais.
Ferramentas: CUSTOMERIO_GET_TRIGGERS e CUSTOMERIO_GET_TRIGGER
Listar todos os triggers para um broadcast:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
broadcast_id | integer | Sim | O ID do broadcast/campanha |
Obter um trigger específico:
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
broadcast_id | integer | Sim | O ID da campanha/broadcast |
trigger_id | string | Sim | Identificador do trigger (ex.: 456 ou 5-37) |
Armadilhas Conhecidas
| Armadilha | Detalhes |
|---|---|
| Parâmetros de audiência mutuamente exclusivos | CUSTOMERIO_TRIGGER_BROADCAST requer EXATAMENTE UM de recipients, ids, emails, per_user_data ou data_file_url — fornecer múltiplos causa erros |
| Limitação de taxa em broadcasts | Broadcasts são limitados a 1 requisição de trigger a cada 10 segundos por ID de broadcast |
| Formato de timestamp Unix | start_ts e end_ts em CUSTOMERIO_GET_MESSAGES devem ser timestamps Unix, não strings ISO |
| Tokens de paginação | Mensagens e newsletters usam paginação baseada em cursor via parâmetro start — use o valor next das respostas anteriores |
| Resolução de ID de segmento | Para segmentar um segmento em um broadcast, primeiro busque os IDs dos segmentos via CUSTOMERIO_GET_SEGMENTS, depois referencie pelo ID em recipients.segment.id |
Referência Rápida
| Slug da Ferramenta | Propósito |
|---|---|
CUSTOMERIO_TRIGGER_BROADCAST | Disparar um broadcast para uma audiência definida |
CUSTOMERIO_GET_MESSAGES | Recuperar métricas de entrega de mensagens com filtros |
CUSTOMERIO_GET_SEGMENTS | Listar todos os segmentos de audiência |
CUSTOMERIO_GET_SEGMENT_DETAILS | Obter detalhes de um segmento específico |
CUSTOMERIO_LIST_NEWSLETTERS | Paginar através de newsletters |
CUSTOMERIO_LIST_TRANSACTIONAL_MESSAGES | Listar templates de mensagens transacionais |
CUSTOMERIO_GET_TRIGGERS | Listar todas as execuções de trigger para um broadcast |
CUSTOMERIO_GET_TRIGGER | Inspecionar uma execução de trigger específica |
Desenvolvido por Composio