Skip to main content

Introdução

A integração com o MailerLite adiciona seus clientes pagantes ao MailerLite quando ocorrem eventos de pagamento. Ela pode adicionar clientes a grupos, armazenar dados de pagamento nos campos de assinantes e iniciar fluxos de automação, para que suas listas de e-mail reflitam a atividade real de pagamentos. O MailerLite é uma plataforma de marketing por e-mail para newsletters, campanhas e automações. Use essa integração para gerenciar assinantes com base na atividade de pagamentos, em sequências de onboarding, segmentação de clientes e campanhas direcionadas.
Esta integração faz a autenticação com uma chave de API do MailerLite. Para criar uma, abra a página de integrações do MailerLite e clique em Generate new token.

Começando

1

Open the Webhook Section

No dashboard do Dodo Payments, acesse Developer → Webhooks e clique em Add endpoint.
Caixa de diálogo Add endpoint com MailerLite selecionado no menu suspenso Integration
2

Select MailerLite

Na lista Integration, selecione MailerLite.
3

Enter API Key

Cole sua chave de API do MailerLite no campo API key. O Dodo Payments a envia como um header Authorization em cada entrega.
4

Configure Transformation

Edite o código em Transformation code para que cada evento se torne uma solicitação de assinante do MailerLite. Comece pelos exemplos abaixo.
5

Test & Create

Em Test this code, execute a transformação em um payload de exemplo e clique em Create endpoint.
6

Done

Agora, os eventos de pagamento adicionam e atualizam assinantes nos seus grupos do MailerLite.

Exemplos de Código de Transformação

A maioria dos exemplos envia uma solicitação POST para a API de assinantes do MailerLite. O MailerLite cria o assinante ou atualiza o assinante existente com o mesmo endereço de e-mail. Esse upsert nunca remove campos ou grupos que você não incluir.

Adicionar cliente após um pagamento bem-sucedido

Este exemplo adiciona o cliente a um grupo quando um pagamento é concluído. Substitua your-group-id-here pelo ID de um grupo do MailerLite.
add_customer.js

Adicionar assinante a vários grupos com base no produto

Este exemplo adiciona todos os clientes pagantes a um grupo de clientes e também adiciona a um grupo premium os clientes que pagam $100 ou mais.
product_segmentation.js

Adicionar novo assinante após a ativação da assinatura

Este exemplo adiciona o cliente a dois grupos de assinantes e armazena os detalhes do plano quando uma assinatura se torna ativa.
subscription_subscriber.js

Atualizar assinante após o cancelamento da assinatura

Este exemplo atualiza um assinante existente quando uma assinatura é cancelada. Ele envia uma solicitação de POST upsert identificada pelo endereço de e-mail, porque o endpoint de atualização PUT do MailerLite requer o ID do assinante no MailerLite, que não está presente no payload do Dodo Payments. O upsert adiciona o assinante ao grupo de churn e mantém os outros grupos aos quais ele pertence.
subscription_cancelled.js

Adicionar cliente com campos personalizados

Este exemplo armazena dados de localização, contato e pagamento nos campos do assinante. Crie primeiro os campos personalizados no MailerLite, conforme descrito em Configuração de campos personalizados.
custom_fields.js

Acionar automação por evento

Este exemplo atualiza um campo de acionamento a cada pagamento bem-sucedido. Crie uma automação no MailerLite que seja iniciada quando last_payment_trigger mudar.
trigger_automation.js

Dicas

  • Crie campos personalizados no MailerLite antes de usá-los em uma transformação.
  • Use grupos para segmentar clientes por produto, nível do plano ou comportamento de compra.
  • Configure fluxos de automação no MailerLite que sejam iniciados quando um campo for atualizado.
  • Envie uma solicitação POST para /subscribers para fazer upsert, evitando erros de assinantes duplicados.
  • Armazene metadados de pagamento em campos personalizados para obter mais informações sobre seus clientes.
  • Teste com um grupo pequeno antes de ativar a integração para todos os pagamentos.

Configuração de campos personalizados

Crie cada campo personalizado no MailerLite antes que uma transformação grave nele:
  1. Abra o dashboard do MailerLite.
  2. Acesse Subscribers → Fields.
  3. Clique em Create field e adicione campos como:
    • total_spent (Number)
    • customer_since (Date)
    • subscription_plan (Text)
    • payment_method (Text)
    • last_payment_amount (Number)

Solução de problemas

  • Verifique se a chave de API está correta e ativa.
  • Verifique se o endereço de e-mail é válido de acordo com a RFC 2821.
  • Verifique se cada ID de grupo está correto e existe na sua conta.
  • O MailerLite não reativa assinantes que tiveram a entrega rejeitada ou foram marcados como spam por meio da API. Para inscrever novamente um assinante que cancelou a inscrição anteriormente, adicione resubscribe: true ao corpo da solicitação POST.
  • Verifique se cada campo personalizado existe no MailerLite.
  • Verifique se os nomes dos campos correspondem exatamente. Eles diferenciam maiúsculas de minúsculas.
  • Verifique se cada valor corresponde ao tipo do campo: texto, número ou data.
  • A API do MailerLite permite 120 solicitações por minuto.
  • Use o endpoint em lote ao processar muitos assinantes.
  • Adicione uma estratégia de backoff para cenários de alto volume.
  • Verifique se os IDs de grupo são strings numéricas.
  • Verifique se os grupos existem na sua conta do MailerLite.
  • Uma solicitação PUT com groups remove o assinante de todos os grupos que não estejam listados. Uma solicitação POST apenas adiciona grupos.

Referência da API

O endpoint de criação ou upsert de assinantes do MailerLite aceita estes parâmetros principais: Para consultar a documentação completa da API, acesse MailerLite Developers.
Última modificação em 26 de setembro de 2026