saas de e-commerce
WhatsApp para plataforma de e-commerce, com cada lojista vendendo pelo próprio número
Leve o WhatsApp para a sua plataforma de e-commerce: cada lojista conecta o próprio número, o carrinho parado vira conversa, a vitrine sai em carrossel e o pós-venda chega com nota e rastreio, na API não-oficial ou na Oficial.
SaaS testa 14 dias com o time técnico ajudando na integração.
- conexões na D-API
- 1.875
- de uptime garantido em contrato
- 99,9%
- datacenters no Brasil
- 4
- por ligação de WhatsApp na API não-oficial
- R$ 0
Lojista escolhe a modalidade
Quem quer custo fixo usa a API não-oficial. Quem precisa de template aprovado para campanha usa a Oficial, pela mesma rota de envio.
Vitrine que leva para o produto
Carrossel com foto e botão de URL para a página do produto, gerado a partir do catálogo da loja.
Cupom com botão de copiar
Na API Oficial, o template aceita botão copy_code com o cupom, montado pelo backend a partir de couponCode.
Número validado antes do primeiro envio
POST /api/v1/contacts/check confirma se o telefone do checkout está no WhatsApp.
Numa plataforma de e-commerce, o WhatsApp aparece em três momentos da jornada: antes da compra, quando o cliente tem dúvida ou largou o carrinho; durante, quando precisa de ajuda com o pagamento; e depois, quando quer saber da nota e do rastreio. O WhatsApp para plataforma de e-commerce transforma esses três momentos em fluxos que o seu software dispara a partir dos eventos da loja, pelo número de cada lojista.
A decisão que mais pesa nesse segmento é qual modalidade cada lojista vai usar. Esta página começa por ela e depois mostra os fluxos de vitrine, carrinho e pós-venda com a D-API.
API não-oficial ou Oficial, lojista a lojista
O e-commerce mistura dois tipos de mensagem com regras diferentes. Aviso de pedido e conversa de atendimento são o dia a dia. Campanha de reativação, lançamento e cupom para a base inteira são marketing. A D-API deixa a sua plataforma oferecer as duas modalidades na mesma integração, e o lojista escolhe.
Na API não-oficial, o lojista conecta o número por QR code dentro do seu painel, a mensagem sai livre e não há tarifa por mensagem. Para quem fala muito com os próprios clientes, o custo fica fixo por conexão.
Na API Oficial, o lojista conecta pelo Embedded Signup num popup hospedado pela D-API. Fora da janela de 24 horas desde a última mensagem do cliente, só sai template aprovado, e cada categoria tem a sua tarifa, cobrada pela Meta na conta do próprio lojista. A D-API cobra da sua plataforma o mesmo preço por conexão. Para lojistas com operação de campanha maior, esse é o caminho que costuma ser exigido.
O ponto que interessa ao seu time é que o código de envio é um só. O connectionId da conexão Oficial funciona como sessionId nas rotas normais, e o webhook normalizado chega no mesmo formato da não-oficial. O que muda é a regra de negócio que decide, conexão a conexão, se a mensagem pode sair livre ou precisa de template.
Vitrine em carrossel
Produto bom vende pela foto. O seu software já tem o catálogo da loja, então pode montar a vitrine sozinho: os mais vistos pelo cliente, uma coleção nova, os itens parecidos com o que ficou no carrinho. O carrossel envia de 2 a 10 cards, cada um com imagem, texto e botões, e o botão de URL leva direto para a página do produto na loja.
Os cards precisam ter o mesmo tipo e quantidade de botões, então padronize: um botão “Ver produto” com a URL e, se fizer sentido, uma resposta rápida “Tenho dúvida” que abre atendimento. O clique na resposta rápida chega no webhook, e o seu sistema sabe de qual produto o cliente quer falar.
Carrinho parado vira conversa
O cliente que abandona o carrinho geralmente parou por uma dúvida: frete, prazo, tamanho, forma de pagamento. Uma mensagem no WhatsApp que abre espaço para a pergunta costuma funcionar melhor do que mais um e-mail. O fluxo é direto: o evento de carrinho abandonado da loja chama o seu backend, que espera o intervalo configurado pelo lojista e envia a mensagem pela conexão da loja.
Antes do primeiro envio, vale validar o número que o cliente digitou no checkout. POST /api/v1/contacts/check recebe uma lista de números e diz quais estão registrados no WhatsApp. Número que não está vira SMS ou e-mail, e o seu sistema não perde envio com telefone errado. A página de contatos pela API cobre essa e outras consultas.
Consentimento é parte do fluxo. Só fale com quem aceitou receber mensagens da loja, registre esse aceite no seu banco e ofereça uma forma simples de sair da lista. O opt-in bem feito protege a relação do lojista com o cliente e a reputação da sua plataforma.
Cupom com botão de copiar na API Oficial
Para o lojista na API Oficial, a campanha de cupom sai por template aprovado. A rota POST /api/v1/messages/send/template aceita variáveis do corpo e parâmetros de botão em buttons[], e o backend da D-API monta os components da Graph API. Um botão copy_code recebe o cupom em couponCode:
POST /api/v1/messages/send/template
{
"sessionId": "loja-7731-oficial",
"to": "5541988880000",
"template": {
"name": "cupom_volta_cliente",
"language": "pt_BR",
"bodyVariables": ["Marina", "15%"],
"buttons": [
{ "index": 0, "subType": "copy_code", "couponCode": "VOLTA15" }
]
}
}
O index é a posição do botão no template, a partir de 0. A mesma união aceita url, para completar o sufixo de um link dinâmico, e order_details e payment_request, com o valor em reais. Templates são criados por conexão com POST /api/v1/connections/cloud-api/{id}/templates, o que permite ao seu painel oferecer modelos prontos ao lojista. A referência completa está na documentação da D-API, e a página de templates pela API explica categorias e aprovação.
Pós-venda com nota, rastreio e Pix
Depois da compra, o WhatsApp responde às perguntas antes que o cliente as faça:
- Nota fiscal.
POST /api/v1/messages/send/documentenvia o PDF comfileNameecaption, assim que a nota é emitida. - Rastreio. O evento de despacho da loja gera um texto com o código e o link da transportadora. Quando a loja tem a informação de saída para entrega, outro aviso fecha o ciclo.
- Pagamento pendente. Pedido com Pix aguardando pode receber o botão Pix com a chave e o valor. A confirmação vem do provedor de pagamento da loja.
- Troca e devolução. A resposta do cliente chega no webhook e abre um atendimento no seu sistema com o pedido já identificado.
Os status message.delivered e message.read chegam por webhook, e o lojista vê no painel se o cliente recebeu o aviso.
Por onde começar
Defina primeiro a regra de modalidade por lojista e guarde o tipo de cada conexão no seu banco. Depois implemente o pós-venda, que é o fluxo de menor risco e maior volume, e só então o carrinho e a vitrine. Para o lojista que pedir campanha, conecte a API Oficial e ofereça os templates prontos. A modelagem completa de conexões e cobrança está na página de API de WhatsApp para SaaS.
Time D-API. Atualizado em .
Perguntas frequentes
A D-API se integra com alguma plataforma de loja virtual pronta?
Não existe integração nativa com plataformas de loja. Quem integra é o seu software: os eventos da loja chamam a API REST da D-API, e as respostas dos clientes chegam no seu webhook.
Posso mandar recuperação de carrinho pela API não-oficial?
Tecnicamente, sim: na não-oficial a mensagem sai livre, sem template. A decisão sobre consentimento e frequência é do lojista, e vale a regra de só falar com quem aceitou receber mensagens da loja.
Quem paga as mensagens de marketing na API Oficial?
O próprio lojista, na conta Meta (WABA) dele. A D-API cobra da sua plataforma só a conexão, pelo mesmo preço da não-oficial.
Dá para enviar a nota fiscal pelo WhatsApp?
Sim. POST /api/v1/messages/send/document envia o PDF por URL ou base64, com nome de arquivo e legenda. Na API Oficial, fora da janela de 24 horas, o envio depende de um template aprovado.
Consigo criar os templates do lojista pela API?
Sim. Para conexões da API Oficial, POST /api/v1/connections/cloud-api/{id}/templates cria o template na WABA, e GET .../templates lista os aprovados.