Pular para o conteúdo
D-APITestar grátis

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/document envia o PDF com fileName e caption, 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.

A gente também é SaaS

SaaS liberado pelo time testa 14 dias grátis, com um grupo de onboarding em que o time técnico da D-API acompanha a integração no seu produto.

Continue por aqui

Liberar seu teste grátis

Responda rapidinho e o time libera seu teste pelo WhatsApp, com o time técnico ajudando na integração.

Seus dados são usados só pra liberar o teste. Sem spam.