saas de atendimento e helpdesk
WhatsApp para plataforma de atendimento com a mesma conversa que o cliente vê no celular
Leve o WhatsApp para a sua plataforma de atendimento com uma caixa de entrada fiel ao aparelho: mensagens de todos os dispositivos, edições, leituras e ligações chegam por webhook, e o atendente responde e liga sem sair da tela.
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
Inbox que bate com o celular
O que o atendente manda pelo app chega com fromMe: true. Edições, exclusões, reações e leituras também viram evento.
Ligação no navegador do atendente
Na API não-oficial, chamadas de WhatsApp entram e saem pela sua plataforma, com áudio por WebSocket e sem custo extra.
Etiquetas que funcionam como filas
Etiquetas do WhatsApp criadas e aplicadas pela API, com webhook quando alguém muda a etiqueta pelo celular.
Roteamento entre parceiros na Oficial
Num número com Conversation Routing, a sua plataforma assume, passa ou solta uma conversa por API.
Uma plataforma de atendimento vive ou morre pela confiança do atendente na caixa de entrada. Se a mensagem que ele mandou pelo celular não aparece no sistema, se a edição do cliente não chega ou se a conversa mostra “não lida” quando já foi respondida, o time volta para o celular e a sua plataforma vira enfeite. O WhatsApp para plataforma de atendimento precisa, antes de tudo, de uma caixa de entrada fiel ao que acontece no aparelho.
Esta página mostra como um helpdesk, uma central omnichannel ou um software de suporte monta essa caixa de entrada com a D-API, e como somar ligações e o roteamento da API Oficial ao produto.
Uma caixa de entrada que bate com o aparelho
O ganho para a sua plataforma é o atendente parar de conferir no celular. Isso depende de três tipos de evento chegando no seu webhook.
Mensagens dos dois lados. O cliente escreve e chega messages.received. O atendente responde pela sua plataforma e chega messages.sent, disparado para envios feitos pela API. E quando alguém responde pelo próprio celular ou por outro dispositivo conectado, a mensagem chega em messages.received com fromMe: true. Tratando os três, a conversa no seu sistema é a mesma do aparelho.
Mudanças depois do envio. Edição chega como messages.received com type: "edited_message" e o original_message_id. Mensagem apagada chega como message.deleted. Reação chega com type: "reaction". Cada uma atualiza a mensagem certa na tela, sem duplicar.
Status de entrega e leitura. message.delivered e message.read mostram ao atendente se o cliente recebeu e leu, com deduplicação de 30 segundos na D-API. No sentido inverso, POST /api/v1/chats/read marca a conversa como lida quando o atendente abre o chamado, e POST /api/v1/chats/presence mostra “digitando” para o cliente enquanto ele escreve.
Um handler organizado por tipo de evento deixa isso legível:
switch (evt.event) {
case "messages.received":
if (evt.data.type === "edited_message") return inbox.applyEdit(evt);
if (evt.data.type === "reaction") return inbox.applyReaction(evt);
return inbox.append(evt, { direction: evt.data.fromMe ? "out" : "in" });
case "messages.sent":
return inbox.confirmOutgoing(evt);
case "message.delivered":
case "message.read":
return inbox.updateStatus(evt);
case "message.deleted":
return inbox.markDeleted(evt);
}
Os eventos chegam com o sessionId da conexão e um traceId, que vale guardar no log junto com o identificador do chamado. A lista completa de eventos e seus campos está na página de eventos de webhook.
Do primeiro dia ao histórico completo
Cliente novo da sua plataforma não quer começar com a caixa vazia. Na criação da sessão, historySync sincroniza o histórico de conversas do aparelho ao conectar. Para reprocessar o que já está armazenado, por exemplo depois de uma migração do seu banco, POST /api/v1/history/sync reenvia o histórico ao seu webhook no formato messages.received, com vazão limitada por delivery.maxRps. O guia de histórico de conversas explica as opções.
Para telas de busca e reconciliação, a API também lista as conversas da conexão. GET /api/v1/chats traz os chats com paginação de até 100 itens e busca por nome ou telefone, e GET /api/v1/chats/{chatId}/messages pagina as mensagens de um chat, com busca por conteúdo. As rotas de arquivar, fixar e silenciar completam o que o atendente faz no app. A página de conversas pela API detalha cada uma.
Etiquetas como filas
Muitas equipes já organizam o WhatsApp por etiquetas, que no app recente aparecem como Listas. A sua plataforma pode usar essas etiquetas como filas ou status de atendimento. POST /api/v1/labels/upsert cria as etiquetas, POST /api/v1/labels/attach aplica no chat quando o chamado muda de fila, e o webhook labels.association.chat avisa quando alguém troca a etiqueta pelo celular. Assim o supervisor que ainda usa o app e o atendente que usa a sua plataforma enxergam a mesma fila.
Ligações dentro da plataforma
Atendimento por WhatsApp também é voz: o cliente liga para o número da empresa esperando ser atendido. Na API não-oficial, a sua plataforma recebe e faz chamadas de WhatsApp sem custo extra por ligação.
Com o recebimento ligado na conexão, cada chamada que entra gera uma oferta em tempo real. A sua plataforma mostra a chamada tocando para o atendente disponível, e o atendimento acontece no navegador: o backend chama POST /api/v1/calls/accept e entrega ao navegador só a URL de mídia, por onde o áudio trafega via WebSocket. Para ligar de volta, POST /api/v1/calls/stream inicia a chamada com o mesmo protocolo de áudio. As chamadas por stream atendidas são gravadas, e a gravação chega no evento call.audio. A página de central de atendimento com ligações mostra como montar filas de voz.
Mais de um parceiro no mesmo número Oficial
Na API Oficial, é comum o cliente da sua plataforma ter outro parceiro no mesmo número, como um fornecedor de chatbot ou de campanhas. Sem regra, os dois recebem tudo e respondem a mesma pessoa. A Meta resolve com o Conversation Routing, em que cada conversa tem um dono.
A D-API expõe esse controle por API. GET /api/v1/connections/cloud-api/{id}/routing mostra os outros parceiros e o papel da D-API no número, e POST /api/v1/connections/cloud-api/{id}/thread-control troca o dono de uma conversa com três ações: take (assumir, quando a D-API é o parceiro de escalonamento), pass (entregar para outro parceiro) e release (soltar a conversa). Na prática, o robô do outro parceiro atende primeiro e, quando o cliente pede um humano, a sua plataforma assume. O passo a passo está na documentação da D-API e na página sobre API Oficial com mais de um parceiro.
Por onde começar
Comece pela fidelidade da caixa de entrada. Conecte um número de teste, mande mensagens pelo celular e pela API, edite, apague e reaja, e confira se o seu sistema reflete tudo. Depois ligue o historySync para clientes novos, as etiquetas como filas e, quando o time pedir voz, o recebimento de chamadas. A visão geral de modelagem e cobrança por conexão está na página de API de WhatsApp para SaaS.
Time D-API. Atualizado em .
Perguntas frequentes
Vários atendentes podem usar o mesmo número?
Sim. O número é uma conexão, e a distribuição entre atendentes é regra da sua plataforma. Todos respondem pelo mesmo sessionId, e o seu sistema registra quem enviou cada mensagem.
Consigo carregar as conversas antigas quando o cliente conecta?
Sim. A criação de sessão aceita historySync para sincronizar o histórico do aparelho ao conectar, e POST /api/v1/history/sync reenvia o histórico armazenado ao seu webhook no formato messages.received.
Mensagens de grupo também chegam?
Chegam, com is_group e group_name no evento. Se a sua plataforma atende só conversas individuais, ignoreGroups descarta os eventos de grupo na própria conexão.
A D-API substitui a minha plataforma de atendimento?
Não. A D-API é a infraestrutura de WhatsApp, voz e SMS. A caixa de entrada, a distribuição, os relatórios e a experiência do atendente continuam sendo o seu produto.
Como fica a cobrança com muitos atendentes?
A D-API cobra por conexão ativa, ou seja, por número conectado, e não por atendente nem por mensagem na API não-oficial.