Omnisend Automação

Automação Omnisend

Automatize operações de marketing de e-commerce — crie e atualize contatos, gerencie listas de assinantes com paginação baseada em cursor, execute operações em lote e segmente públicos — tudo orquestrado através da integração MCP do Composio.

Documentação do toolkit: composio.dev/toolkits/omnisend

---

Configuração

1. Conecte sua conta Omnisend através do servidor MCP do Composio em https://rube.app/mcp
2. O agente solicitará um link de autenticação se não houver uma conexão ativa
3. Após a conexão, todas as ferramentas OMNISEND_* ficam disponíveis para execução

---

Fluxos de Trabalho Principais

1. Criar ou Atualizar um Contato

Faça upsert de um contato pelo identificador de e-mail com status de assinatura, campos de perfil e mensagem de boas-vindas opcional.

Ferramenta: OMNISEND_CREATE_OR_UPDATE_CONTACT

Parâmetro	Tipo	Obrigatório	Descrição
identifiers	array	Sim	Pelo menos um objeto de identificador com id (email), type (email), opcionalmente channels.email.status (subscribed, nonSubscribed, unsubscribed) e sendWelcomeMessage (booleano)
firstName	string	Não	Primeiro nome do contato
lastName	string	Não	Sobrenome do contato
gender	string	Não	m ou f
birthdate	string	Não	Formato: YYYY-MM-DD
country	string	Não	Nome completo do país
countryCode	string	Não	Código ISO 3166-1 alpha-2 (ex.: US)
city	string	Não	Nome da cidade
address	string	Não	Endereço
postalCode	string	Não	Código postal/CEP

---

2. Listar Contatos com Paginação

Recupere contatos em lotes com filtros opcionais por e-mail, telefone, status, segmento ou tag.

Ferramenta: OMNISEND_LIST_CONTACTS

Parâmetro	Tipo	Obrigatório	Descrição
limit	integer	Não	Resultados por página (padrão: 100, máximo: 250)
after	string	Não	Cursor para a próxima página (ContactID codificado em base64)
before	string	Não	Cursor para a página anterior
email	string	Não	Filtrar por endereço de e-mail exato
phone	string	Não	Filtrar por número de telefone completo com código do país
status	string	Não	Filtrar por: subscribed, nonSubscribed, unsubscribed
segmentID	integer	Não	Filtrar por ID do segmento
tag	string	Não	Filtrar por tag (ex.: VIP)

---

3. Obter Detalhes do Contato

Recupere o perfil completo de um único contato quando você já possui o ID do contato.

Ferramenta: OMNISEND_GET_CONTACT

Parâmetro	Tipo	Obrigatório	Descrição
contactId	string	Sim	Identificador único do contato (ex.: 60e7412b1234567890abcdef)

---

4. Atualizar um Contato Existente

Atualize campos específicos de um contato pelo ID sem sobrescrever todo o registro.

Ferramenta: OMNISEND_UPDATE_CONTACT

Requer o contactId e os campos a serem atualizados. Obtenha o ID do contato primeiro via OMNISEND_LIST_CONTACTS ou OMNISEND_GET_CONTACT.

---

5. Operações em Lote

Processe muitos registros de forma assíncrona em uma única chamada — contatos, produtos, pedidos, eventos ou categorias.

Ferramenta: OMNISEND_CREATE_BATCH

Parâmetro	Tipo	Obrigatório	Descrição
method	string	Sim	POST ou PUT
endpoint	string	Sim	Alvo: contacts, orders, products, events, categories
items	array	Sim	Array de objetos de payload para cada operação
eventID	string	Condicional	Obrigatório quando o endpoint é events

Use operações em lote para evitar limites de taxa ao processar grandes conjuntos de dados.

---

Armadilhas Conhecidas

Armadilha	Detalhes
Identificador obrigatório	OMNISEND_CREATE_OR_UPDATE_CONTACT requer pelo menos um identificador no array identifiers — apenas o tipo email é suportado
Paginação baseada em cursor	OMNISEND_LIST_CONTACTS usa cursores after/before codificados em base64, não números de página — siga os cursores para evitar dados incompletos
Resolução do ID do contato	OMNISEND_UPDATE_CONTACT requer um contactId — sempre resolva-o primeiro através de operações de lista ou obtenção
Restrições do método em lote	OMNISEND_CREATE_BATCH aceita apenas métodos POST ou PUT — sem DELETE ou PATCH
Dependência do ID do evento	Ao agrupar eventos, o parâmetro eventID é obrigatório — omiti-lo faz com que o lote falhe

---

Referência Rápida

Slug da Ferramenta	Propósito
OMNISEND_CREATE_OR_UPDATE_CONTACT	Criar ou fazer upsert de um contato por e-mail
OMNISEND_LIST_CONTACTS	Listar contatos com filtragem e paginação baseada em cursor
OMNISEND_GET_CONTACT	Obter perfil completo de um único contato pelo ID
OMNISEND_UPDATE_CONTACT	Atualizar campos específicos em um contato existente
OMNISEND_CREATE_BATCH	Operações assíncronas em lote para contatos, produtos, pedidos, eventos

---

Desenvolvido por Composio