Sankhya 9 min 2026-08-28

Como integrar pedidos do WhatsApp ao Sankhya

Estruture conversas do WhatsApp, consulte preço contextual e crie pedidos no Sankhya com confirmação do cliente, autorização de API e tratamento de exceções.

No WhatsApp, o comprador pode mandar ‘repete o último’, uma foto de lista ou três mensagens corrigindo quantidade. O ERP, por outro lado, exige parceiro, empresa, TOP, produto, unidade e condições coerentes. A integração precisa manter estado entre esses dois mundos.

Um assistente de pedido deve confirmar o carrinho antes de gravar. Ele não substitui as regras do Sankhya nem promete estoque e preço sem consultar a fonte adequada.

Webhook, contexto e carrinho

A WhatsApp Business Platform entrega eventos ao webhook. O serviço valida origem, responde rápido e coloca o evento em fila. Mensagens são agrupadas por conversa e transformadas em intenção, itens e pendências.

O carrinho temporário guarda versões. Se o cliente troca dez por doze unidades, o histórico mostra a alteração. Áudio e imagem podem ser transcritos ou lidos, mas campos incertos voltam como pergunta objetiva.

Identificação e catálogo

Telefone não deve ser a única prova de identidade. O fluxo pode solicitar CNPJ, código de cliente ou confirmação de endereço e então localizar o parceiro. O catálogo exposto é limitado aos produtos e regras daquele cliente.

A consulta de preços contextualizados do Sankhya considera condições da negociação e aceita até 50 produtos por solicitação. Ela pode simular inclusão, mas a própria documentação alerta para desempenho; cache curto e chamadas seletivas evitam sobrecarga.

Do resumo ao pedido

O cliente recebe itens, quantidades, valores e condição para confirmar. O middleware então chama o serviço de inclusão do módulo comercial via Gateway ou endpoint liberado. A camada de autorização do Sankhya deve permitir somente os serviços necessários ao usuário da integração.

NUNOTA, número e status retornam para a conversa e para o log. A chave externa impede duplicidade quando o webhook é repetido. Bloqueio comercial ou item rejeitado vira atendimento humano, não mensagem genérica de sucesso.

Operação e conformidade

Templates aprovados são usados em mensagens proativas fora da janela aplicável. Opt-in, retenção de conversa e dados pessoais precisam seguir a finalidade definida pela empresa.

O painel operacional acompanha fila, tempo sem resposta, pedidos criados, intervenções e erros por etapa. Credenciais não ficam no chatbot e toda chamada ao ERP usa correlação.

Recorte de implantação

Comece por clientes recorrentes, itens codificados e uma única TOP. Exclua no primeiro momento negociações com condição especial, múltiplas empresas ou cálculo complexo que não possa ser confirmado automaticamente.

Precisamos de conversas anonimizadas, regras de identificação, tabela de produtos, acesso de homologação e política do canal. O ganho é medido por pedidos concluídos e tempo poupado, não por quantidade de mensagens respondidas.

Fontes técnicas consultadas

Documentação oficial usada para conferir recursos, limitações e caminhos de integração citados neste guia.

Leia também