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.