Como aquecer contas via API da Snov.io

Este guia mostra como aquecer contas de remetente na Snov.io usando a API de Aquecimento de E-mail.

Use a API de Aquecimento de E-mail para automatizar o aquecimento de remetentes em escala. Crie e gerencie campanhas, monitore o progresso da entregabilidade e mantenha contas de remetente continuamente aquecidas como parte do seu fluxo de prospecção por meio de solicitações de API.

Antes de começar

Criar campanha de aquecimento

Aqueça uma conta de remetente antes de utilizá-la em campanhas de prospecção. Este método inicia uma nova campanha de aquecimento com as configurações definidas por você.

Input obrigatório:

Os parâmetros obrigatórios definem a base do aquecimento: qual conta será aquecida e quantos e-mails ela enviará por dia.

• email_account_id — a conta de e-mail que você deseja aquecer
• per_day — quantos e-mails de aquecimento enviar por dia. Você pode definir entre 1 e 1000 e-mails por dia, dependendo do seu plano. Consulte os limites de aquecimento aqui.

Input opcional:

Os parâmetros opcionais permitem ajustar sua estratégia de aquecimento, o conteúdo dos e-mails e os provedores com os quais o aquecimento será realizado.

Você também pode melhorar o desempenho com opções avançadas, como pool premium de remetentes (apenas domínios corporativos), domínios de rastreamento personalizados e proxy dinâmico.

• strategy — velocidade de aumento do volume de envio: progressive aumenta gradualmente o volume diário, steady mantém o volume fixo durante todo o período
• from — volume diário inicial ao usar a estratégia progressive. Escolha entre 1 e 5 e certifique-se de que o valor não seja maior que o objetivo definido em per_day
• increase — quanto aumentar o volume diário a cada dia ao usar a estratégia progressive. Escolha entre 1 e 5
• email_content — conteúdo enviado durante o aquecimento: autogenerated (padrão) permite que a Snov.io gere o conteúdo com IA; specific permite fornecer seu próprio modelo
• subject — assunto personalizado do e-mail (1–200 caracteres). Necessário se email_content for definido como specific
• body — corpo personalizado do e-mail (1–10000 caracteres). Necessário seemail_content for definido como specific
• reply_rate — porcentagem de e-mails de aquecimento recebidos que recebem resposta. Escolha entre 10 e 45. O padrão é 30
• campaign_deadline — data em que o aquecimento deve ser encerrado (AAAA-MM-DD). Deixe em branco se não desejar definir um prazo
• providers — provedores de e-mail com os quais realizar o aquecimento. Escolha entre gmail, microsoft, ou other
• send_to_paid_domain — define se os e-mails de aquecimento também serão enviados para domínios pagos. O padrão é: false
• enable_ctd — ativa um domínio de rastreamento personalizado para este aquecimento. O padrão é: false
• enable_proxy — ativa um proxy dinâmico para este aquecimento. O padrão é false
• schedule_id — agenda de envio que você deseja associar ao aquecimento
• template_name — nome de um modelo de e-mail salvo que você deseja utilizar

Obter lista de campanhas de aquecimento

Obtenha uma visão geral de todas as campanhas de aquecimento das suas contas de remetente, com a opção de filtrar por status ou navegar pelos resultados com paginação.

Input obrigatório:

Nenhuma — este método retorna todos os aquecimentos caso você não especifique parâmetros opcionais.

Input opcional:

Os parâmetros opcionais permitem filtrar por status da campanha e controlar a paginação, limitando os resultados a campanhas ativas, pausadas, concluídas ou com erro, além de definir quantos resultados exibir por página.

• page — página de resultados a ser exibida. Começa em 1 (padrão)
• per_page — quantidade de resultados por página. Escolha entre 20, 50, ou 100. O padrão é 20
• status — restringe os resultados a um status específico: active, paused, completed, ou error. Deixe em branco para retornar todas as campanhas de aquecimento

Obter informações da campanha de aquecimento

Revise a configuração atual e o status de uma campanha de aquecimento.

Este método retorna todos os detalhes da campanha, incluindo configurações da estratégia, limites diários, estatísticas atuais de entregabilidade e a conta de e-mail conectada. Assim, você pode monitorar o progresso e verificar as configurações antes de fazer alterações.

Input obrigatório:

id — a campanha de aquecimento que você deseja consultar. Você pode obtê-lo na resposta do método Obter lista de campanhas de aquecimento

Atualizar campanha de aquecimento

Ajuste a estratégia de aquecimento, limites diários, status ou configurações de conteúdo sem reiniciar a campanha.

Este método atualiza parcialmente uma campanha de aquecimento existente. Apenas os campos enviados serão alterados; todas as demais configurações permanecerão inalteradas.

Input obrigatório:

id — a campanha de aquecimento que você deseja atualizar. Você pode obtê-lo na resposta do método Obter lista de campanhas de aquecimento

Input opcional:

make_endless: true — remove a data-limite da campanha para que o aquecimento continue indefinidamente. Essa opção substitui qualquer prazo definido anteriormente.

Todos os demais parâmetros opcionais funcionam da mesma forma que no método Criar campanha de aquecimento, permitindo ajustar qualquer parte da configuração do aquecimento.

Consulte Criar campanha de aquecimento para ver a lista completa de parâmetros.

Obter estatísticas de aquecimento

Monitore o progresso da taxa de entrega na caixa de entrada e identifique provedores de e-mail em que o aquecimento apresenta desempenho abaixo do esperado.

Este método retorna estatísticas de entregabilidade diárias e por provedor para uma campanha de aquecimento.

Você pode visualizar estatísticas em períodos predefinidos ou definir um intervalo de datas personalizado, o que é útil para acompanhar a evolução em diferentes etapas ou comparar o desempenho ao longo do tempo.

Input obrigatório:

id — a campanha de aquecimento para a qual você deseja obter estatísticas. Você pode obtê-lo na resposta do método Obter lista de campanhas de aquecimento

• period — intervalo de tempo predefinido: two_weeks ou month. Obrigatório se você não fornecer date_from / date_to
• date_from — data inicial do intervalo personalizado (AAAA-MM-DD). Obrigatória se você não fornecerperiod
• date_to — data final do intervalo personalizado (AAAA-MM-DD). Deve ser igual ou posterior a date_from e igual ou posterior à data de início da campanha. Obrigatória se você não fornecer period

Excluir campanha de aquecimento

Remova uma campanha de aquecimento que você não precisa mais. Esta ação não pode ser desfeita.

Este método exclui permanentemente uma campanha de aquecimento e suas estatísticas. Elas não ficarão mais acessíveis por meio dos demais métodos da API de aquecimento. Use esta opção quando o aquecimento tiver sido concluído ou quando você não precisar mais acompanhar a campanha.

Input obrigatório:

id — campanha de aquecimento que você deseja excluir. Você pode obtê-lo na resposta do método Obter lista de campanhas de aquecimento.