![\"note\"](\"https:\/\/snov.io\/knowledgebase\/wp-content\/themes\/knowledgebase-n\/assets\/img\/ph_circle-wavy-warning.svg\")
<\/div>\nThe Snov.io API is available on all Sales Suite plans<\/a>.<\/p>\n A API da Snov.io est\u00e1 dispon\u00edvel em todos os planos da Su\u00edte de Vendas<\/a>.<\/p>\n<\/div>\n<\/div>\n M\u00e9todos da API de Aquecimento de E-mail<\/a><\/p>\n O que voc\u00ea pode fazer com a API de Aquecimento de E-mail:<\/strong><\/p>\n 1) Conectar contas e iniciar aquecimentos em massa por meio de solicita\u00e7\u00f5es de API<\/p>\n 2) Escolher uma estrat\u00e9gia de envio com base na etapa da sua prospec\u00e7\u00e3o \u2014 progressiva para preparar contas ou est\u00e1vel para manter a reputa\u00e7\u00e3o<\/p>\n 3) Aquecer contas no Gmail, Microsoft ou outros provedores SMTP<\/p>\n 4) Controlar limites de envio e configura\u00e7\u00f5es em cada etapa do aquecimento<\/p>\n 5) Obter estat\u00edsticas para acompanhar o progresso das contas<\/p>\n<\/div>\n<\/div>\n Voc\u00ea precisar\u00e1 de duas coisas para usar a API de Aquecimento de E-mail: uma conta de e-mail conectada e credenciais de API para autentica\u00e7\u00e3o.<\/p>\n Conta de e-mail<\/strong><\/p>\n Pelo menos uma conta de e-mail do remetente deve estar conectada ao seu workspace, seja pelo app<\/a> ou pelo m\u00e9todo da API \"Adicionar conta de e-mail\"<\/a>.<\/p>\n Autentica\u00e7\u00e3o<\/strong><\/p>\n Todas as solicita\u00e7\u00f5es da API da Snov.io exigem um token de acesso. Para ger\u00e1-lo:<\/p>\n O token de acesso \u00e9 v\u00e1lido por 1 hora (3600 segundos).<\/p>\n A seguir, veja os m\u00e9todos da API organizados por etapa do fluxo de trabalho.<\/p>\n<\/div>\n Aque\u00e7a uma conta de remetente antes de utiliz\u00e1-la em campanhas de prospec\u00e7\u00e3o. Este m\u00e9todo inicia uma nova campanha de aquecimento com as configura\u00e7\u00f5es definidas por voc\u00ea.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n Os par\u00e2metros obrigat\u00f3rios definem a base do aquecimento: qual conta ser\u00e1 aquecida e quantos e-mails ela enviar\u00e1 por dia.<\/p>\n Input opcional:<\/strong><\/p>\n Os par\u00e2metros opcionais permitem ajustar sua estrat\u00e9gia de aquecimento, o conte\u00fado dos e-mails e os provedores com os quais o aquecimento ser\u00e1 realizado.<\/p>\n Voc\u00ea tamb\u00e9m pode melhorar o desempenho com op\u00e7\u00f5es avan\u00e7adas, como pool premium de remetentes (apenas dom\u00ednios corporativos), dom\u00ednios de rastreamento personalizados e proxy din\u00e2mico.<\/p>\n Obtenha uma vis\u00e3o geral de todas as campanhas de aquecimento das suas contas de remetente, com a op\u00e7\u00e3o de filtrar por status ou navegar pelos resultados com pagina\u00e7\u00e3o.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n Nenhuma \u2014 este m\u00e9todo retorna todos os aquecimentos caso voc\u00ea n\u00e3o especifique par\u00e2metros opcionais.<\/p>\n Input opcional:<\/strong><\/p>\n Os par\u00e2metros opcionais permitem filtrar por status da campanha e controlar a pagina\u00e7\u00e3o, limitando os resultados a campanhas ativas, pausadas, conclu\u00eddas ou com erro, al\u00e9m de definir quantos resultados exibir por p\u00e1gina.<\/p>\n Revise a configura\u00e7\u00e3o atual e o status de uma campanha de aquecimento.<\/p>\n Este m\u00e9todo retorna todos os detalhes da campanha, incluindo configura\u00e7\u00f5es da estrat\u00e9gia, limites di\u00e1rios, estat\u00edsticas atuais de entregabilidade e a conta de e-mail conectada. Assim, voc\u00ea pode monitorar o progresso e verificar as configura\u00e7\u00f5es antes de fazer altera\u00e7\u00f5es.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n Ajuste a estrat\u00e9gia de aquecimento, limites di\u00e1rios, status ou configura\u00e7\u00f5es de conte\u00fado sem reiniciar a campanha.<\/p>\n Este m\u00e9todo atualiza parcialmente uma campanha de aquecimento existente. Apenas os campos enviados ser\u00e3o alterados; todas as demais configura\u00e7\u00f5es permanecer\u00e3o inalteradas.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n Input opcional:<\/strong><\/p>\n Todos os demais par\u00e2metros opcionais funcionam da mesma forma que no m\u00e9todo Criar campanha de aquecimento<\/a>, permitindo ajustar qualquer parte da configura\u00e7\u00e3o do aquecimento.<\/p>\n Consulte Criar campanha de aquecimento<\/a> para ver a lista completa de par\u00e2metros.<\/p>\n 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.<\/p>\n Este m\u00e9todo retorna estat\u00edsticas de entregabilidade di\u00e1rias e por provedor para uma campanha de aquecimento.<\/p>\n Voc\u00ea pode visualizar estat\u00edsticas em per\u00edodos predefinidos ou definir um intervalo de datas personalizado, o que \u00e9 \u00fatil para acompanhar a evolu\u00e7\u00e3o em diferentes etapas ou comparar o desempenho ao longo do tempo.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n Remova uma campanha de aquecimento que voc\u00ea n\u00e3o precisa mais. Esta a\u00e7\u00e3o n\u00e3o pode ser desfeita.<\/p>\n Este m\u00e9todo exclui permanentemente uma campanha de aquecimento e suas estat\u00edsticas. Elas n\u00e3o ficar\u00e3o mais acess\u00edveis por meio dos demais m\u00e9todos da API de aquecimento. Use esta op\u00e7\u00e3o quando o aquecimento tiver sido conclu\u00eddo ou quando voc\u00ea n\u00e3o precisar mais acompanhar a campanha.<\/p>\n Input obrigat\u00f3rio:<\/strong><\/p>\n\n
<\/div>\nAntes de come\u00e7ar<\/h2>\n
\n
Criar campanha de aquecimento<\/h2>\n
\n
email_account_id<\/code><\/span> \u2014 a conta de e-mail que voc\u00ea deseja aquecer<\/li>\nper_day<\/code><\/span> \u2014 quantos e-mails de aquecimento enviar por dia. Voc\u00ea pode definir entre 1 e 1000 e-mails por dia<\/strong>, dependendo do seu plano. Consulte os limites de aquecimento aqui<\/a>.<\/li>\n<\/ul>\n\n
strategy<\/code><\/span> \u2014 velocidade de aumento do volume de envio: progressive<\/code><\/span> aumenta gradualmente o volume di\u00e1rio, steady<\/code><\/span> mant\u00e9m o volume fixo durante todo o per\u00edodo<\/li>\nfrom<\/code><\/span> \u2014 volume di\u00e1rio inicial ao usar a estrat\u00e9gia progressive<\/code><\/span>. Escolha entre 1 e 5 e certifique-se de que o valor n\u00e3o seja maior que o objetivo definido em per_day<\/code><\/span><\/li>\nincrease<\/code><\/span> \u2014 quanto aumentar o volume di\u00e1rio a cada dia ao usar a estrat\u00e9gia progressive<\/code><\/span>. Escolha entre 1 e 5<\/li>\nemail_content<\/code><\/span> \u2014 conte\u00fado enviado durante o aquecimento: autogenerated<\/code><\/span> (padr\u00e3o) permite que a Snov.io gere o conte\u00fado com IA; specific<\/code><\/span> permite fornecer seu pr\u00f3prio modelo<\/li>\nsubject<\/code><\/span> \u2014 assunto personalizado do e-mail (1\u2013200 caracteres). Necess\u00e1rio se email_content<\/code><\/span> for definido como specific<\/code><\/span><\/li>\nbody<\/code><\/span> \u2014 corpo personalizado do e-mail (1\u201310000 caracteres). Necess\u00e1rio seemail_content<\/code><\/span> for definido como specific<\/code><\/span><\/li>\nreply_rate<\/code><\/span> \u2014 porcentagem de e-mails de aquecimento recebidos que recebem resposta. Escolha entre 10 e 45. O padr\u00e3o \u00e9 30<\/li>\ncampaign_deadline<\/code><\/span> \u2014 data em que o aquecimento deve ser encerrado (AAAA-MM-DD). Deixe em branco se n\u00e3o desejar definir um prazo<\/li>\nproviders<\/code><\/span> \u2014 provedores de e-mail com os quais realizar o aquecimento. Escolha entre gmail<\/code><\/span>, microsoft<\/code><\/span>, ou other<\/code><\/span><\/li>\nsend_to_paid_domain<\/code><\/span> \u2014 define se os e-mails de aquecimento tamb\u00e9m ser\u00e3o enviados para dom\u00ednios pagos. O padr\u00e3o \u00e9: false<\/code><\/span><\/li>\nenable_ctd<\/code><\/span> \u2014 ativa um dom\u00ednio de rastreamento personalizado para este aquecimento. O padr\u00e3o \u00e9: false<\/code><\/span><\/li>\nenable_proxy<\/code><\/span> \u2014 ativa um proxy din\u00e2mico para este aquecimento. O padr\u00e3o \u00e9 false<\/code><\/span><\/li>\nschedule_id<\/code><\/span> \u2014 agenda de envio que voc\u00ea deseja associar ao aquecimento<\/li>\ntemplate_name<\/code><\/span> \u2014 nome de um modelo de e-mail salvo que voc\u00ea deseja utilizar<\/li>\n<\/ul>\nObter lista de campanhas de aquecimento<\/strong><\/h2>\n
\n
page<\/code><\/span> \u2014 p\u00e1gina de resultados a ser exibida. Come\u00e7a em 1 (padr\u00e3o)<\/li>\nper_page<\/code><\/span> \u2014 quantidade de resultados por p\u00e1gina. Escolha entre 20<\/code><\/span>, 50<\/code><\/span>, ou 100<\/code><\/span>. O padr\u00e3o \u00e9 20<\/li>\nstatus<\/code><\/span> \u2014 restringe os resultados a um status espec\u00edfico: active<\/code><\/span>, paused<\/code><\/span>, completed<\/code><\/span>, ou error<\/code><\/span>. Deixe em branco para retornar todas as campanhas de aquecimento<\/li>\n<\/ul>\nObter informa\u00e7\u00f5es da campanha de aquecimento<\/strong><\/h2>\n
id<\/code><\/span> \u2014 a campanha de aquecimento que voc\u00ea deseja consultar. Voc\u00ea pode obt\u00ea-lo na resposta do m\u00e9todo Obter lista de campanhas de aquecimento<\/a><\/p>\nAtualizar campanha de aquecimento<\/h2>\n
id<\/code><\/span> \u2014\u00a0a campanha de aquecimento que voc\u00ea deseja atualizar. Voc\u00ea pode obt\u00ea-lo na resposta do m\u00e9todo Obter lista de campanhas de aquecimento<\/a><\/p>\nmake_endless: true<\/code><\/span> \u2014 remove a data-limite da campanha para que o aquecimento continue indefinidamente. Essa op\u00e7\u00e3o substitui qualquer prazo definido anteriormente.<\/p>\nObter estat\u00edsticas de aquecimento<\/strong><\/h2>\n
id<\/code><\/span> \u2014 a campanha de aquecimento para a qual voc\u00ea deseja obter estat\u00edsticas. Voc\u00ea pode obt\u00ea-lo na resposta do m\u00e9todo Obter lista de campanhas de aquecimento<\/a><\/p>\n\n
period<\/code><\/span> \u2014 intervalo de tempo predefinido: two_weeks<\/code><\/span> ou month<\/code><\/span>. Obrigat\u00f3rio se voc\u00ea n\u00e3o fornecer date_from<\/code><\/span> \/ date_to<\/code><\/span><\/li>\ndate_from<\/code><\/span> \u2014 data inicial do intervalo personalizado (AAAA-MM-DD). Obrigat\u00f3ria se voc\u00ea n\u00e3o fornecerperiod<\/code><\/span><\/li>\ndate_to<\/code><\/span> \u2014 data final do intervalo personalizado (AAAA-MM-DD). Deve ser igual ou posterior a date_from<\/code><\/span> e igual ou posterior \u00e0 data de in\u00edcio da campanha. Obrigat\u00f3ria se voc\u00ea n\u00e3o fornecer period<\/code><\/span><\/li>\n<\/ul>\nExcluir campanha de aquecimento<\/strong><\/h2>\n
id<\/code><\/span> \u2014 campanha de aquecimento que voc\u00ea deseja excluir. Voc\u00ea pode obt\u00ea-lo na resposta do m\u00e9todo Obter lista de campanhas de aquecimento<\/a>.<\/p>\nArtigos relacionados<\/strong><\/h3>\n