ComposioHQ/Instantly-Automation

Automação Instantly

Automatize seu outreach de cold email com o Instantly — crie e gerencie campanhas com sequências de múltiplas etapas, configure horários de envio, importe leads em lote, gerencie contas de envio e acompanhe o desempenho das campanhas — tudo através de comandos em linguagem natural.

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

---

Configuração

1. Adicione o servidor MCP do Composio à configuração do seu cliente:

   https://rube.app/mcp
   

2. Conecte sua conta Instantly quando solicitado (autenticação por chave de API).
3. Comece a emitir comandos em linguagem natural para gerenciar suas campanhas de outreach.

---

Fluxos de Trabalho Principais

1. Listar Contas de Envio

Recupere todas as contas de email configuradas no seu workspace do Instantly, com filtragem por status e provedor.

Ferramenta: INSTANTLY_LIST_ACCOUNTS

Exemplo de prompt:

"Mostre todas as contas de envio ativas no meu workspace Instantly"

Parâmetros principais:

• status — Filtrar por status: 1 (Ativo), 2 (Pausado), -1 (Erro de Conexão), -2 (Erro de Soft Bounce), -3 (Erro de Envio)
• provider_code — Filtrar por provedor: 1 (Custom IMAP/SMTP), 2 (Google), 3 (Microsoft), 4 (AWS)
• search — Pesquisar por substring de email ou domínio
• limit — Máximo de itens (1-100)
• starting_after — Cursor de paginação da resposta anterior
• tag_ids — UUIDs de tags separados por vírgula

---

2. Criar uma Campanha

Inicie uma nova campanha de outreach com agendamento, sequências de email, variantes de teste A/B e configuração de envio.

Ferramenta: INSTANTLY_CREATE_CAMPAIGN

Exemplo de prompt:

"Crie uma campanha Instantly chamada 'Outreach Q1' que envie de Segunda a Sexta, das 9h às 17h, horário Central, com uma sequência de 3 etapas de email"

Parâmetros principais:

• name (obrigatório) — Nome da campanha
• campaign_schedule (obrigatório) — Configuração de agendamento:
  • schedules (obrigatório) — Array de objetos de agendamento, cada um com:
    • name — Nome do agendamento
    • timing — {from: "09:00", to: "17:00"} (formato HH:mm)
    • days — Mapa de índices dos dias "0" (Dom) a "6" (Sáb) para booleanos
    • timezone — Valores suportados incluem "America/Chicago", "America/Detroit", "America/Boise", "America/Anchorage"
  • start_date / end_date — Datas no formato ISO 8601
• email_list — Array de endereços de email das contas de envio (devem ser contas pré-configuradas; use INSTANTLY_LIST_ACCOUNTS para descobrir endereços válidos)
• sequences — Array (apenas o primeiro elemento é usado) contendo:
  • steps — Array de objetos de etapa com:
    • type — Deve ser "email"
    • delay — Dias até o PRÓXIMO email (inteiro, mínimo 0)
    • variants — Array de objetos {subject, body} para teste A/B
• daily_limit — Limite diário de envio
• email_gap — Minutos entre emails
• stop_on_reply — Parar campanha quando o lead responder (booleano)
• stop_on_auto_reply — Parar em respostas automáticas (booleano)
• open_tracking / link_tracking — Habilitar rastreamento (booleanos)

Notas sobre fusos horários:

• Verificados em funcionamento: "America/Chicago" (Central), "America/Detroit" (Leste), "America/Boise" (Montanha)
• Mapeamento automático: "America/New_York" mapeia para "America/Detroit", "America/Denver" mapeia para "America/Boise"
• NÃO suportados: "America/Los_Angeles", "US/Pacific" — use "America/Anchorage" ou "America/Dawson" como alternativas

---

3. Atualizar Configurações da Campanha

Modifique o agendamento, limites de envio, sequências ou configurações de rastreamento de uma campanha existente.

Ferramenta: INSTANTLY_UPDATE_CAMPAIGN

Exemplo de prompt:

"Atualize minha campanha Instantly para aumentar o limite diário para 100 e habilitar o rastreamento de abertura"

Parâmetros principais:

• id (obrigatório) — UUID da campanha
• Qualquer combinação de: name, campaign_schedule, email_list, sequences, daily_limit, email_gap, stop_on_reply, open_tracking, link_tracking, etc.
• Defina qualquer parâmetro como null para removê-lo

---

4. Gerenciar Listas de Leads e Importação em Lote

Crie listas de leads dedicadas e importe prospects em lote para o direcionamento de campanhas.

Ferramentas: INSTANTLY_CREATE_LEAD_LIST, INSTANTLY_ADD_LEADS_BULK

Exemplo de prompt:

"Crie uma lista de leads chamada 'Prospects Q1' e adicione 50 leads à minha campanha Instantly"

Parâmetros principais para criar listas de leads:

• Nome da lista e configuração

Parâmetros principais para importação em lote de leads:

• ID da campanha ou lista para importar
• Array de objetos de lead com email e metadados
• Opções de tratamento de duplicatas
• Configurações de verificação de leads

---

5. Revisar Detalhes da Campanha

Recupere a configuração completa da campanha para verificar configurações, inspecionar sequências ou se preparar para atualizações.

Ferramenta: INSTANTLY_GET_CAMPAIGN

Exemplo de prompt:

"Mostre todos os detalhes da minha campanha Instantly"

Parâmetros principais:

• id (obrigatório) — UUID da campanha

---

6. Listar Todas as Campanhas

Enumere todas as campanhas no seu workspace com filtros opcionais e paginação.

Ferramenta: INSTANTLY_LIST_CAMPAIGNS

Exemplo de prompt:

"Liste todas as minhas campanhas Instantly"

Parâmetros principais:

• Filtros opcionais e parâmetros de paginação

---

Armadilhas Conhecidas

• Suporte limitado a fusos horários: A API Instantly aceita um conjunto restrito de strings de fuso horário. Pacific Time ("America/Los_Angeles") NÃO é suportado. Use "America/Anchorage" (UTC-9/UTC-8) ou "America/Dawson" (UTC-7 o ano todo) como alternativas.
• Payloads de agendamento inválidos causam erros 400: Um campaign_schedule malformado (sem days, from, to ou schedules) gera HTTP 400. 400s repetidos indicam problemas no payload, não falhas transitórias.
• Sequências devem estar completas: Cada etapa da sequência requer um type válido ("email"), delay e pelo menos uma variante com subject e body. Variantes incompletas bloqueiam a criação da campanha.
• Apenas o primeiro elemento da sequência é usado: A API processa apenas sequences[0]. Sequências adicionais são ignoradas.
• email_list deve referenciar contas existentes: O campo email_list exige endereços de email de contas de envio pré-configuradas no seu workspace Instantly, não endereços de destinatários arbitrários. Sempre use INSTANTLY_LIST_ACCOUNTS para descobrir endereços de envio válidos.
• Erros de escopo 401 na criação de campanha: A criação de campanha pode falhar com "Invalid scope. Required: campaigns:create". Atualize as permissões da sua chave de API antes de tentar novamente operações de escrita.
• Campos de leitura podem diferir: Nomes de campos nas respostas de INSTANTLY_GET_CAMPAIGN podem diferir dos payloads de criação (por exemplo, timing.from_ vs timing.from). Faça parsing defensivo.

---

Referência Rápida

Ação	Slug da Ferramenta	Parâmetros Obrigatórios
Listar contas de envio	INSTANTLY_LIST_ACCOUNTS	Nenhum (filtros opcionais)
Criar campanha	INSTANTLY_CREATE_CAMPAIGN	name, campaign_schedule
Atualizar campanha	INSTANTLY_UPDATE_CAMPAIGN	id
Obter detalhes da campanha	INSTANTLY_GET_CAMPAIGN	id
Listar campanhas	INSTANTLY_LIST_CAMPAIGNS	Nenhum (filtros opcionais)
Criar lista de leads	INSTANTLY_CREATE_LEAD_LIST	Nome da lista
Importar leads em lote	INSTANTLY_ADD_LEADS_BULK	ID da campanha/lista, leads

---

Fornecido por Composio