Integração ActiveCampaign, Notazz e TPL

Como enviar e-mail de acompanhamento de entrega usando Notazz e TPL Logística


Autor: Réulison Silva Publicado em: Março 28, 2025

Recentemente tive um desafio como profissional de Web Analytics e Developer, há muitos anos que trabalho com diversas plataformas de Automação de Marketing, desde o antigo Infusion Soft (agora é Keap) até os mais recentes como o Brevo. Mas dentre eles eu destaco o Active Campaing, possui suporte nativo com diversas plataformas e sua documentação de API é bastante clara, objetiva e muito prestativa.

Trabalhando para Petvi descobri que existia um enorme problema em sua jornada de compra, eles não conseguiam criar um fluxo de automação que acompanhasse a entrega do produto, gerando desconfiança e reclamações por parte dos clientes, ouvindo esse problema, me propuz a solucionar o mesmo.

Mesmo não trabalhando como BackEnd na Petvi eu implementei uma o solução onde hoje o cliente possui todo acompanhmento desde a geração de Nota Fiscal até o recebimento do produto. Agora vamos ver como isso foi feito.

Integração Entre ActiveCampaign, Notazz e TPL para Disparo Personalizado de E-mails na Petvi

Este artigo detalha a integração entre ActiveCampaign, Notazz e TPL para automatizar o envio de e-mails personalizados sobre a entrega de pedidos para os clientes da Petvi. Essa solução combina conhecimentos de Marketing, Web Analytics e Desenvolvimento para otimizar a comunicação com os clientes.

Objetivo

O principal objetivo dessa integração é coletar informações sobre o status da nota fiscal e logística do pedido, para que os e-mails de acompanhamento sejam disparados de forma personalizada pelo ActiveCampaign.

Tecnologias Utilizadas

  • PHP para processamento dos dados e requisições às APIs.
  • GuzzleHttp para comunicação com as APIs.
  • dotenv para gerenciamento seguro de credenciais.

Fluxo da IntegraçãoFluxo da Integração

1. Disparo via Webhook do ActiveCampaign

A API é acionada por um Webhook configurado em uma automação no ActiveCampaign.

2. Recebimento dos dados do pedido

O script recebe os dados de CPF, e-mail e data do pedido a partir de uma requisição.

Implementação do Código

Protegendo Credenciais com Variáveis de Ambiente

Para evitar expor chaves de API no código, utilizamos a biblioteca dotenv. As credenciais são armazenadas no arquivo .env:

3. Consulta à API da Notazz

A API da Notazz é consultada para verificar se a Nota Fiscal Eletrônica (NF-e) foi autorizada.

4. Obtenção de status logístico na TPL

Caso a NF-e esteja autorizada, a API da TPL é utilizada para recuperar dados sobre a entrega, como previsão de chegada e código de rastreamento.

5. Atualização no ActiveCampaign

Os dados coletados são enviados para o ActiveCampaign, que dispara e-mails personalizados aos clientes.

Implementação do Código

Protegendo Credenciais com Variáveis de Ambiente

Para evitar expor chaves de API no código, utilizamos a biblioteca dotenv. As credenciais são armazenadas no arquivo .env:

NOTAZZ_API_KEY=SuaChaveAPI
TPL_API_KEY=SuaChaveAPI
TPL_TOKEN=SeuToken
TPL_EMAIL=SeuEmail
ACTIVE_CAMPAIGN_TOKEN=SeuTokenActiveCampaign

O carregamento das variáveis é feito com:

dotenv\Dotenv::createImmutable(__DIR__)->load();

Otimização do Código

  • O código foi reestruturado para:
  • Usar GuzzleHttp para chamadas de API de forma mais limpa.
  • Validar entradas para evitar erros.
  • Armazenar credenciais de forma segura.
  • Melhorar a legibilidade e modularidade.

Aqui está um trecho código:

require_once 'vendor/autoload.php';
require 'notazz-php.php';

dotenv\Dotenv::createImmutable(__DIR__)->load();

// Coleta e validação dos dados
$cpf = $_REQUEST['contact']['fields']['cpf'] ?? '';
$email = $_REQUEST['contact']['email'] ?? '';
$dataOriginal = $_REQUEST['contact']['fields']['data_ordem_pedido'] ?? '';
if (empty($cpf) || empty($email) || empty($dataOriginal)) {
    die('Erro: Dados insuficientes para processar a solicitação.');
}

// Consulta NF-e, Status Logístico e Envio ao ActiveCampaign
// (código otimizado conforme descrito no artigo)

São vários emails, um para cada etapa que selecionamos que fosse relevante enviar para o cliente. Segue apenas 1 de amostra, usei a apenas HTML e CSS e a barra de progresso fiz usando esse código.

E-mail de entrega de Nota Fiscal e acompanhemento de pedido

Gostou? O código completo da API está no meu Github.

Conclusão

Essa integração pretende melhorar a experiência do cliente, automatizando a comunicação sobre entregas. A abordagem focada em segurança, organização e eficiência permite uma manutenção simplificada e maior confiabilidade do sistema. E claro, não só email, mas podemos usar a mesma API para enviar notificações de acompanhamento de pedido via SMS e WhatsApp.

Perguntas Frequentes

O que essa integração faz?

Essa integração automatiza o envio de e-mails personalizados sobre a entrega de pedidos, coletando informações da Notazz e da TPL e atualizando os contatos no ActiveCampaign.

Como os e-mails são disparados?

Os e-mails são disparados através de um Webhook acionado em uma automação do ActiveCampaign.

Como as credenciais são protegidas?

As chaves de API e credenciais são armazenadas em um arquivo .env e carregadas dinamicamente usando a biblioteca dotenv.

Qual é o benefício dessa automação?

A automação melhora a experiência do cliente, fornecendo informações atualizadas sobre o status da entrega e eliminando a necessidade de envio manual de e-mails.

O que acontece se a NF-e não for autorizada?

Se a NF-e não for autorizada, o processo é interrompido e nenhum e-mail é enviado. E tentamos novamente mais tarde, até a NF-e estar com status de “Autorizada” até ao máximo de 5 tentativas em dias diferentes.

Leia também