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

saas de delivery

WhatsApp para plataforma de delivery que aguenta o pico de sexta à noite

Ponha o WhatsApp na sua plataforma de delivery: cada restaurante avisa o status do pedido pelo próprio número, cobra com botão Pix e recebe o endereço como localização, com envio em fila para o horário de pico.

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
  • Pico sem request travado

    Com async: true, a API enfileira o envio e responde na hora com um commandId. O resultado chega no webhook command.result.

  • Mensagens na ordem certa

    Com sequential: true, os envios para o mesmo cliente saem um de cada vez, na ordem em que a API recebeu.

  • Pix dentro da conversa

    Botão de cópia da chave Pix, com valor e identificação do pedido, enviado pelo número do restaurante.

  • Sem tarifa por mensagem

    Na API não-oficial, cada restaurante é uma conexão com custo fixo. Sexta movimentada não muda a fatura.

Delivery é o segmento em que o WhatsApp mais sofre com horário. Das 19h às 22h, uma plataforma de delivery dispara o mesmo tipo de mensagem para milhares de clientes, em centenas de restaurantes, todos ao mesmo tempo: pedido recebido, em preparo, saiu para entrega, chegou. Se o envio trava, o cliente liga para o restaurante perguntando do pedido, e o restaurante liga para o seu suporte. O WhatsApp para plataforma de delivery precisa ser desenhado para esse pico desde o primeiro dia.

Esta página mostra como uma plataforma de pedidos, cardápio digital ou gestão de restaurantes monta esse fluxo com a D-API: o status do pedido em fila, a cobrança com Pix, a localização e a ligação para quando o entregador não acha o endereço.

Cada restaurante fala pelo próprio número

O cliente fez o pedido no restaurante, e é do número do restaurante que ele espera notícia. Cada restaurante da sua plataforma conecta o próprio WhatsApp numa conexão isolada, criada pelo seu backend com POST /api/v1/sessions. Redes com várias lojas ganham uma conexão por loja. Como as conexões têm IP dedicado e não dividem recurso entre si, o restaurante com mais pedidos da noite não deixa o vizinho mais lento.

O custo segue a mesma lógica. Na API não-oficial, a cobrança é por conexão ativa, sem tarifa por mensagem, então a sexta-feira de recorde custa o mesmo que a terça tranquila. Para uma plataforma que cobra mensalidade dos restaurantes, isso deixa a margem do WhatsApp fixa.

Status do pedido em fila, sem travar no pico

O envio padrão é síncrono: a API responde depois que o WhatsApp entrega o comando. Isso funciona no dia a dia, mas no pico o seu backend acumula requests abertos. A saída é o modo assíncrono. Com async: true, a D-API enfileira o comando, responde na hora com um commandId e manda o resultado no webhook command.result.

O segundo problema do pico é a ordem. Uma mensagem com foto do pedido pode sair depois do texto enviado logo em seguida. Com sequential: true junto do async, os envios para o mesmo cliente saem um de cada vez, na ordem em que chegaram na API, enquanto os de outros clientes continuam em paralelo:

POST /api/v1/messages/send/text
{
  "sessionId": "rest-2093-loja-centro",
  "to": "5531977776666",
  "text": "Pedido #4821 saiu para entrega. O entregador chega em cerca de 25 minutos.",
  "async": true,
  "sequential": true
}
{
  "commandId": "9f1c8f2e-4b7a-4f10-9c3d-2e1a8b5d7c40",
  "success": true,
  "status": "queued"
}

Dois cuidados fazem isso funcionar. Grave o commandId junto do pedido e use como chave de idempotência, porque o command.result tem retentativa e pode chegar mais de uma vez. E envie em série para o mesmo cliente: a ordem preservada é a de chegada na API, então requests disparados em paralelo pelo seu sistema não têm sequência garantida. A resposta do enfileiramento chega na hora, então esperar por ela custa pouco. Os detalhes estão na documentação da D-API e no guia de comandos assíncronos.

Pix na conversa do pedido

Pedido feito pelo WhatsApp tem um passo que costuma escapar: o pagamento. O botão Pix coloca a chave do restaurante na conversa, com botão de cópia e valor:

POST /api/v1/interactive/send/pix
{
  "sessionId": "rest-2093-loja-centro",
  "to": "5531977776666",
  "content": "Pedido #4821: R$ 74,90. Toque para copiar a chave Pix.",
  "pixKey": "[email protected]",
  "pixAmount": 74.9,
  "pixMessage": "Pedido 4821"
}

O endpoint envia a mensagem, e a confirmação do pagamento continua com o provedor que a sua plataforma já usa. Quando o webhook do provedor confirma, o seu sistema manda o “pagamento recebido, pedido em preparo” na mesma conversa. Num restaurante que usa a API Oficial, a mensagem de Pix só sai dentro da janela de 24 horas e chega como texto com a chave em linha própria, porque a Meta não oferece botão de cópia em mensagem livre.

Localização nos dois sentidos

Endereço digitado errado é a origem de muito atraso. O WhatsApp ajuda nas duas pontas.

Quando o cliente manda a localização, ela chega no webhook messages.received com type: "location" e os campos degrees_latitude, degrees_longitude, name e address. O seu sistema grava as coordenadas no pedido e entrega ao entregador um ponto exato no mapa em vez de um endereço ambíguo.

No sentido contrário, POST /api/v1/messages/send/location envia a localização da loja para quem escolheu retirar no balcão. Com sequential: true, ela sai logo depois da confirmação do pedido, sempre na ordem certa.

Quando o entregador não acha o endereço

Mensagem não resolve tudo. Quando o entregador está na porta e o cliente não aparece, uma ligação resolve em segundos. Na API não-oficial, a sua plataforma coloca um botão “ligar para o cliente” no painel do restaurante, e a chamada sai do WhatsApp da loja, sem custo extra por ligação. POST /api/v1/calls/place inicia a chamada, e os eventos call.ringing, call.connected, call.ended ou call.not_answered registram o resultado no pedido. O guia de fazer ligações pela API mostra o modo stream, em que o áudio vai para o navegador do atendente.

Cardápio, grupos e operação

Algumas plataformas vão além do pedido. A API de catálogo cria, edita e exclui produtos e coleções do catálogo business de cada conexão, com preço em decimal, o que permite manter o catálogo do WhatsApp alinhado com o cardápio cadastrado na sua plataforma. Para a operação interna do restaurante, a API de grupos cria grupos com mensagens só de administradores, útil para avisos de turno aos entregadores próprios.

Por onde começar

Comece pelo status do pedido no modo assíncrono, porque é ele que segura o pico. Conecte um restaurante de teste, dispare a sequência completa de um pedido com async e sequential, e trate o command.result com o commandId gravado. Depois acrescente o Pix, a localização e o botão de ligação. A visão geral de modelagem e cobrança está na página de API de WhatsApp para SaaS.

Time D-API. Atualizado em .

Perguntas frequentes

O botão Pix confirma o pagamento?

Não. O endpoint envia a chave Pix com botão de cópia e valor opcional. A confirmação vem do provedor de pagamento que a sua plataforma já usa, e o seu sistema avisa o cliente depois.

Consigo receber a localização que o cliente manda?

Sim. Uma localização enviada pelo cliente chega no webhook messages.received com type location, latitude, longitude, nome e endereço.

Cada restaurante precisa conectar um número?

Sim. Cada restaurante conecta o próprio WhatsApp numa conexão isolada criada pela sua plataforma. Uma rede com várias lojas pode ter uma conexão por loja.

Dá para publicar o cardápio no catálogo do WhatsApp?

A API tem rotas para listar, criar, editar e excluir produtos e coleções do catálogo business da conexão, com preço em decimal. O formato de envio do catálogo para o cliente depende de como a sua plataforma usa esses produtos.

E se o restaurante usar a API Oficial?

O envio continua pela mesma rota. Sessões da API Oficial ignoram o async e respondem de forma síncrona, e fora da janela de 24 horas a mensagem precisa ser um template aprovado.

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.