ComposioHQ/Lemlist-Automation

Automação do Lemlist

Automatize seus fluxos de outreach multicanal do Lemlist — gerencie campanhas, inscreva leads em escala, enriqueça com variáveis personalizadas, exporte dados de campanhas e limpe cancelamentos de inscrição.

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

---

Configuração

1. Adicione o servidor MCP do Composio ao seu cliente: https://rube.app/mcp
2. Conecte sua conta do Lemlist quando solicitado (autenticação via chave de API)
3. Comece a usar os fluxos de trabalho abaixo

---

Fluxos de Trabalho Principais

1. Listar e Descobrir Campanhas

Use LEMLIST_GET_LIST_CAMPAIGNS para enumerar todas as campanhas por status, com suporte a paginação.

Ferramenta: LEMLIST_GET_LIST_CAMPAIGNS
Entradas:
  - status: "running" | "draft" | "archived" | "ended" | "paused" | "errors" (opcional)
  - limit: inteiro (máx. 100, padrão 100)
  - offset: inteiro (deslocamento de paginação)
  - sortBy: "createdAt"
  - sortOrder: "asc" | "desc"

Importante: A resposta pode vir encapsulada como {campaigns: [...], pagination: {...}} em vez de uma lista simples. Sempre extraia da chave campaigns.

2. Obter Detalhes da Campanha

Use LEMLIST_GET_CAMPAIGN_BY_ID para validar a configuração da campanha antes de escrever.

Ferramenta: LEMLIST_GET_CAMPAIGN_BY_ID
Entradas:
  - campaignId: string (obrigatório) — ex.: "cam_A1B2C3D4E5F6G7H8I9"

3. Inscrever Leads em uma Campanha

Use LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN para adicionar leads com opções de descoberta de e-mail, consulta de telefone e enriquecimento do LinkedIn.

Ferramenta: LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN
Entradas:
  - campaignId: string (obrigatório)
  - email: string (obrigatório)
  - firstName, lastName, companyName, companyDomain: string (opcional)
  - jobTitle, phone, linkedinUrl, icebreaker: string (opcional)
  - deduplicate: booleano (impede duplicatas entre campanhas)
  - findEmail, findPhone, verifyEmail, linkedinEnrichment: booleano (opcional)
  - timezone: string (formato IANA, ex.: "America/New_York")

Padrão em lote: Divida os leads em lotes de aproximadamente 50 e registre pontos de verificação entre os lotes.

4. Adicionar Variáveis Personalizadas a um Lead

Use LEMLIST_POST_ADD_VARIABLES_TO_LEAD para enriquecer leads com campos de personalização após a inscrição.

Ferramenta: LEMLIST_POST_ADD_VARIABLES_TO_LEAD
Entradas:
  - leadId: string (obrigatório) — ID interno do lead no Lemlist (NÃO o e-mail)
  - company: string (obrigatório) — deve corresponder ao nome da sua empresa no Lemlist
  - variables: objeto (obrigatório) — pares chave-valor, ex.: {"score": "42", "color": "yellow"}

Importante: Isso NÃO é um upsert — tentar adicionar variáveis que já existem falhará. Resolva o leadId interno via LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL se você tiver apenas o endereço de e-mail.

5. Exportar Leads de uma Campanha

Use LEMLIST_GET_EXPORT_CAMPAIGN_LEADS para baixar leads com filtragem de estado para relatórios ou QA.

Ferramenta: LEMLIST_GET_EXPORT_CAMPAIGN_LEADS
Entradas:
  - campaignId: string (obrigatório)
  - (suporta filtragem de estado e saída JSON/CSV)

6. Cancelar Inscrição de Lead de uma Campanha

Use LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN para interromper o outreach removendo um lead de uma campanha.

Ferramenta: LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN
Entradas:
  - campaignId: string (obrigatório)
  - leadId ou email: string (obrigatório)

---

Armadilhas Conhecidas

Armadilha	Detalhe
Lista de campanhas encapsulada	LEMLIST_GET_LIST_CAMPAIGNS pode retornar {campaigns: [...], pagination: {...}} em vez de um array simples. Sempre extraia da chave campaigns.
Deduplicação entre campanhas	LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN com deduplicação ativada falha com HTTP 500 "Lead already in other campaign" — desative a deduplicação para inscrição intencional entre campanhas.
Falhas em importação em lote	Divida importações em lote para aproximadamente 50 por lote com pontos de verificação para evitar perda de progresso parcial em falhas intermitentes.
leadId inválido	LEMLIST_POST_ADD_VARIABLES_TO_LEAD retorna HTTP 400 "Invalid leadId" ao usar um e-mail como leadId — resolva o ID interno via LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL primeiro.
Colisões de variáveis	LEMLIST_POST_ADD_VARIABLES_TO_LEAD não é um upsert. Adicionar chaves que já existem retorna HTTP 400 "Variables X already exist".

---

Referência Rápida

Slug da Ferramenta	Descrição
LEMLIST_GET_LIST_CAMPAIGNS	Listar todas as campanhas com filtro de status e paginação
LEMLIST_GET_CAMPAIGN_BY_ID	Obter informações detalhadas da campanha por ID
LEMLIST_POST_CREATE_LEAD_IN_CAMPAIGN	Criar e inscrever um lead em uma campanha
LEMLIST_POST_ADD_VARIABLES_TO_LEAD	Adicionar variáveis de personalização personalizadas a um lead
LEMLIST_GET_RETRIEVE_LEAD_BY_EMAIL	Consultar um lead pelo endereço de e-mail
LEMLIST_GET_EXPORT_CAMPAIGN_LEADS	Exportar leads de uma campanha com filtragem de estado
LEMLIST_DELETE_UNSUBSCRIBE_LEAD_FROM_CAMPAIGN	Remover um lead de uma campanha

---

Desenvolvido por Composio