Acompanhamento de entrega com ActiveCampaign, Notazz e TPL Logística

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.

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.

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.

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

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.

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.

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();

• 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.

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

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.

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.

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.