API e webhook em uma frase
A API é a porta pela qual um sistema pede ou envia dados a outro ("crie esta cobrança", "envie esta mensagem"). O webhook é o caminho de volta: o outro sistema avisa o seu quando algo acontece ("o pagamento foi confirmado", "o cliente respondeu").
WhatsApp: API oficial ou QR Code
- API oficial da Meta. É o canal pensado para empresas e para automação. Não depende de um celular ligado e tem regras próprias.
- QR Code. Conecta o número como se fosse o WhatsApp Web. É rápido de ligar, mas não é o canal oficial para operações grandes.
- Janela de 24 horas. Depois que o cliente escreve, você responde livremente por 24 horas. Fora dela, só com modelos de mensagem aprovados. Veja como funciona a janela.
- Custo. As mensagens fora da janela são cobradas pela Meta, pela tabela dela. Isso não é preço do sistema que você contrata.
Para quem quer atender e vender, o LYMOS CRM já vem integrado. Integração sob medida entra quando o WhatsApp precisa conversar com o seu sistema próprio.
Gateways de pagamento
O fluxo comum é este: o sistema cria a cobrança no gateway, o cliente paga, e o gateway avisa por webhook. Três cuidados fazem diferença:
- Confirme pelo webhook, não pela tela de retorno. O cliente pode fechar o navegador antes de voltar ao seu site. A confirmação confiável é a que o gateway envia, ou a que o seu sistema consulta.
- Aceite o mesmo aviso mais de uma vez. Webhooks podem chegar repetidos. O sistema precisa reconhecer que aquele pagamento já foi registrado e não dar baixa duas vezes.
- Não guarde dados de cartão. Use o que o gateway oferece para cobrar sem que o número do cartão passe pelo seu sistema.
O que perguntar a quem vai integrar
| Pergunta | Por que importa |
|---|---|
| E se o webhook chegar duas vezes? | Sem proteção, o pagamento ou a mensagem é registrado em duplicidade |
| E se a API do outro lado cair? | A rotina deve guardar o que ficou pendente e reenviar, sem perder dado |
| Existe ambiente de teste? | Gateways e plataformas costumam ter um. Testar com dinheiro real é risco |
| Quem guarda as chaves e os tokens? | Credenciais são da sua conta. Defina isso no contrato |
| Há registro de tudo que foi enviado e recebido? | Sem registro, ninguém explica um pagamento que não baixou |
| Quem paga as tarifas? | Gateway, mensagens da Meta e planos de plataforma são cobrados por eles, à parte |
| Que dados pessoais trafegam? | A LGPD vale para nome, telefone e CPF que passam entre os sistemas |
Pronto ou sob medida
Se o seu caso é comum, use um produto que já tem a integração: o LYMOS ERP trabalha com Mercado Pago e Asaas, e o CRM com o WhatsApp. Se o seu sistema é próprio ou a regra é diferente, a integração é um serviço do LYMOS Studio.