Como Criar um Assistente no WhatsApp para Rastreamento de Pedidos no WooCommerce

Uma das maiores demandas no suporte de qualquer e-commerce é a clássica pergunta: “Onde está o meu pedido?”. Quando essa operação é manual, a equipe de atendimento perde horas copiando códigos de rastreio e consultando painéis. Integrar um assistente automatizado via WhatsApp conectado diretamente à base do WooCommerce resolve esse gargalo, fornecendo atualizações em tempo real para os clientes sem intervenção humana.

Como Funciona a Arquitetura da Solução

Para que o WhatsApp atue como um assistente de pós-venda seguro e eficiente, precisamos de três pilares integrados no ecossistema WordPress:

1. Camada de Dados (WooCommerce): Onde estão armazenados os status do pedido, código de rastreio (geralmente via metadados de plugins como Correios ou transportadoras) e dados do cliente.
2. Camada de Integração (Webhooks e REST API): A ponte que permite ler dados sob demanda ou disparar alertas assim que o status do pedido é alterado.
3. Camada de Mensageria (WhatsApp Cloud API ou Gateway intermediário): O serviço que processa as mensagens recebidas e envia as respostas estruturadas ao cliente final.

Passo 1: Criando um Endpoint Customizado para Consultas Seguras

Embora a REST API nativa do WooCommerce (/wp-json/wc/v3/orders) permita buscar pedidos, expor essas chaves com permissões amplas em integrações externas não é uma boa prática de segurança. Em implementações que realizo, costumo registrar um endpoint REST customizado e restrito focado unicamente na consulta de status por número do pedido e validação de documento/telefone.

Exemplo de registro de endpoint via functions.php ou plugin próprio:

php
addaction(‘restapiinit’, function () {
registerrestroute(‘loja/v1’, ‘/rastreio/’, array(
‘methods’ => ‘POST’,
‘callback’ => ‘consultarstatuspedidowhatsapp’,
‘permissioncallback’ => ‘returntrue’,
));
});

function consultarstatuspedidowhatsapp(WPRESTRequest $request) {
$orderid = sanitizetextfield($request->getparam(‘orderid’));
$phone = sanitizetextfield($request->get_param(‘phone’));

$order = wc_get_order($order_id);
if (!$order) {
    return new WP_REST_Response(array('mensagem' => 'Pedido não encontrado.'), 404);
}

// Validação de segurança: conferir se o telefone do remetente bate com o pedido
$billing_phone = preg_replace('/D/', '', $order->get_billing_phone());
$clean_phone = preg_replace('/D/', '', $phone);

if (substr($billing_phone, -8) !== substr($clean_phone, -8)) {
    return new WP_REST_Response(array('mensagem' => 'Dados de validação incorretos.'), 403);
}

$tracking_code = $order->get_meta('_correios_tracking_code'); // Ajustar para o metadado da sua transportadora
$status = wc_get_order_status_name($order->get_status());

return new WP_REST_Response(array(
    'pedido' => $order_id,
    'status' => $status,
    'codigo_rastreio' => $tracking_code ?: 'Não disponível no momento',
), 200);

}

Passo 2: Notificações Ativas com Hooks do WooCommerce

Além de permitir que o cliente consulte o status, o assistente pode enviar mensagens ativas sempre que o status mudar (por exemplo, de “Processando” para “Enviado”). Isso reduz drasticamente o volume de chamados receptivos.

Utilizamos o hook nativo woocommerce_order_status_changed:

php
addaction(‘woocommerceorderstatuschanged’, ‘dispararalertawhatsapp’, 10, 4);

function dispararalertawhatsapp($orderid, $oldstatus, $newstatus, $order) {
if ($newstatus === ‘completed’) {
$phone = $order->getbillingphone();
$tracking = $order->getmeta(‘correiostrackingcode’);

    // Disparo para o webhook do provedor WhatsApp (ex: n8n, Evolution API, Twilio)
    wp_remote_post('https://seu-servico-automacao.com/webhook/status-update', array(
        'headers' => array('Content-Type' => 'application/json'),
        'body'    => wp_json_encode(array(
            'telefone' => $phone,
            'pedido'   => $order_id,
            'status'   => 'Pedido Concluído/Enviado',
            'rastreio' => $tracking,
        )),
    ));
}

}

Passo 3: Fluxo Conversacional e Proteção de Dados

No desenho do fluxo no assistente (seja construído via Typebot, n8n ou webhook direto na WhatsApp Cloud API), garanta que:

• O bot responda a palavras-chave simples como “status”, “rastreio” ou o próprio número do pedido.
• Nunca sejam expostos dados sensíveis como endereço completo ou dados de pagamento por mensagem aberta.
• Haja um fallback para atendimento humano caso o cliente informe que houve avaria ou extravio.

Conclusão e Próximos Passos

Transformar o WhatsApp em um canal automatizado de pós-venda integrado ao WooCommerce melhora a experiência de compra e libera sua equipe para focar em vendas e tarefas estratégicas.

Se você precisa estruturar uma integração estável, segura e sob medida entre o WooCommerce e a API do WhatsApp na sua loja virtual, entre em contato para avaliar uma consultoria técnica de implementação.