---
title: "Rastreio de pedidos com API de WhatsApp | D-API"
description: "Rastreio de pedidos pelo WhatsApp com API de WhatsApp: status da transportadora virando mensagem, link com prévia e regras para não encher o cliente."
url: https://d-api.cloud/api-whatsapp-rastreio-de-pedidos
---

Por caso de uso

# Rastreio de pedidos pelo WhatsApp com API

Rastreio de pedidos pelo WhatsApp é transformar os eventos da transportadora ou da plataforma em poucas mensagens que importam: enviado, saiu para entrega, entregue e problemas. Com a API, cada mudança relevante vira aviso automático, com o link de rastreio já na conversa.

Por Time de engenharia D-APIAtualizado em 24 de set de 20265 min de leitura

## Menos "cadê meu pedido" no atendimento

Em loja virtual, a pergunta mais repetida do atendimento costuma ser sobre onde está o pedido. O cliente não quer entrar no site, achar o e-mail com o código e copiar para outro site. Ele quer que o aviso chegue onde ele já está.

Com a [API de WhatsApp](https://d-api.cloud/) conectada ao seu sistema de pedidos, cada mudança relevante de status sai sozinha, e a conversa com o cliente passa a ter o histórico da entrega. Quando ele pergunta, o atendente ou o bot já sabe do que se trata.

## De onde vêm os eventos de status

O WhatsApp é a última ponta. Antes dele, o seu sistema precisa saber o que aconteceu com o pedido. As fontes mais comuns:

-   **Plataforma de e-commerce:** pedido criado, pago, faturado e enviado, geralmente por webhook de pedido.
-   **Gateway de frete ou intermediador de etiquetas:** postagem e movimentação, por webhook ou consulta periódica.
-   **Transportadora própria ou entregador parceiro:** saiu para entrega, entregue e tentativa sem sucesso, pelo app do motorista.

Cada fonte usa um vocabulário diferente. Antes de pensar em mensagem, normalize tudo para uma lista curta de status internos. É essa lista que decide o que o cliente recebe, e não o nome que cada transportadora dá ao evento.

## Mapa de status para mensagem

| Status interno | Envia? | Mensagem |
| --- | --- | --- |
| Pagamento aprovado | Sim | Pedido confirmado e prazo estimado |
| Em separação | Não | Fica visível só na página do pedido |
| Enviado | Sim | Transportadora, código e link de rastreio |
| Em trânsito | Não | Movimentações intermediárias não viram mensagem |
| Saiu para entrega | Sim | Aviso de que chega hoje, pedindo alguém para receber |
| Entregue | Sim | Confirmação e canal para relatar problema |
| Tentativa sem sucesso | Sim | O que aconteceu e o que o cliente precisa fazer |
| Atraso ou devolução | Sim | Explicação honesta e próximo passo |

Na prática, um pedido sem problemas gera quatro mensagens. Os eventos que pedem ação do cliente têm prioridade sobre os puramente informativos.

## Link de rastreio com prévia

No aviso de envio, o link para a página de rastreio é a parte principal. Com `linkPreview`, o WhatsApp mostra um cartão com título e imagem, o que deixa claro que o link é da sua loja e não um golpe:

```
curl -X POST https://api.d-api.cloud/api/v1/messages/send/text \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "loja-pedidos",
    "to": "5511999999999",
    "text": "Seu pedido 10492 foi enviado pela transportadora. Acompanhe a entrega: https://loja.com.br/rastreio/10492",
    "linkPreview": true
  }'
```

Prefira uma página de rastreio no seu domínio, que mostra o status normalizado, em vez do link direto da transportadora. O cliente reconhece a marca, e você controla o que aparece. A prévia depende das meta tags de compartilhamento da página, então teste com um link real antes de ligar o fluxo.

## Regras para não virar spam de status

-   **Status só avança.** Se a transportadora reenvia um evento antigo, ou manda os eventos fora de ordem, ignore qualquer status anterior ao último enviado.
-   **Um aviso por status por pedido.** Grave a combinação pedido e status antes de enviar. O mesmo evento chegando duas vezes não gera segunda mensagem.
-   **Janela de agrupamento.** Se pago e enviado chegam com minutos de diferença, espere um pouco e mande só o mais recente.
-   **Horário de silêncio.** Eventos informativos que chegam de madrugada esperam a manhã. Problemas que pedem ação podem sair antes, com bom senso.
-   **Pedidos com vários volumes** recebem uma mensagem que resume todos, não uma por pacote.

Essas mesmas preocupações de fila e duplicidade aparecem em qualquer aviso disparado por evento. O desenho completo está em [notificações transacionais](https://d-api.cloud/api-whatsapp-notificacoes-transacionais).

## Quando o cliente responde o aviso

Mensagem de rastreio gera resposta: "não vou estar em casa", "pode deixar na portaria", "ainda não chegou". Essas mensagens chegam no seu webhook como `messages.received`, com o número de quem respondeu. Busque o último pedido ativo daquele número e mande a conversa para o atendimento já com o pedido e o status anexados. Perguntas simples sobre onde está a entrega podem ser respondidas automaticamente com o último status normalizado e o link de rastreio.

## Depois da entrega

O aviso de entregue é o melhor momento para perguntar como foi a compra, uma ou duas horas depois, com uma pergunta só. Veja como montar essa etapa em [pesquisa NPS pelo WhatsApp](https://d-api.cloud/api-whatsapp-pesquisa-nps). Lojas com operação maior, com vários números e canais, encontram mais contexto em [API de WhatsApp para e-commerce](https://d-api.cloud/api-whatsapp-para-ecommerce). Se os avisos saem de um sistema interno de logística ou ERP, veja também [API de WhatsApp para operação interna](https://d-api.cloud/api-whatsapp-para-operacao-interna). Para testar o mapa de status com pedidos reais, o trial é de 3 dias, sem cartão.

## Perguntas frequentes

### Quais status de entrega vale avisar pelo WhatsApp?

Os que mudam algo para o cliente: pagamento confirmado, pedido enviado com o código de rastreio, saiu para entrega, entregue e qualquer problema, como tentativa sem sucesso ou devolução. Movimentações entre centros de distribuição ficam para a página de rastreio.

### Como pego os status da transportadora?

A maioria das plataformas de e-commerce, gateways de frete e transportadoras oferece webhook ou API de consulta. O seu sistema recebe ou consulta esses eventos, traduz para o seu status interno e só então decide se envia mensagem.

### O link de rastreio aparece com prévia no WhatsApp?

Pode aparecer. Na D-API o envio de texto aceita a opção linkPreview, que monta o cartão com título e imagem da página, desde que a página de rastreio tenha as meta tags de compartilhamento preenchidas.

### O cliente pode responder a mensagem de rastreio?

Pode e vai. Perguntas como onde está meu pedido ou não estava em casa chegam pelo webhook como mensagens recebidas. Encaminhe para o atendimento ou responda automaticamente com o último status conhecido do pedido.

### Isso substitui o e-mail de rastreio?

Não precisa substituir. O e-mail continua útil como registro. O WhatsApp é onde o cliente vê o aviso na hora, por isso concentre nele os momentos que pedem ação, como receber a entrega ou resolver um problema.

Teste a API de WhatsApp da D-API3 dias grátis, sem cartão.[Começar trial grátis](https://app.d-api.cloud/register)

## Continue lendo

-   [Por caso de usoPesquisa NPS pelo WhatsApp](https://d-api.cloud/api-whatsapp-pesquisa-nps)
-   [Por caso de usoNotificações transacionais](https://d-api.cloud/api-whatsapp-notificacoes-transacionais)
-   [Por caso de usoCódigo de verificação (OTP)](https://d-api.cloud/api-whatsapp-codigo-de-verificacao)
-   [Por caso de usoConfirmação de agendamento](https://d-api.cloud/api-whatsapp-confirmacao-de-agendamento)

## Teste a API de WhatsApp da D-API

Trial de 3 dias com acesso completo. Sem cartão, sem fidelidade.

[Começar trial grátis](https://app.d-api.cloud/register)[Ver documentação](https://docs.d-api.cloud/)