Como colocar WhatsApp no seu app do Lovable com a API oficial

Dá para colocar o WhatsApp oficial num app feito no Lovable em uma tarde: o Lovable escreve a integração, e a API da OneSendz cuida da conexão com a Meta. Você testa tudo sem enviar nada de verdade e só troca a chave no fim.

O que você vai precisar

• O seu projeto no Lovable, com backend (funções de servidor) ligado.
• Uma chave de teste da OneSendz (oszt_). Veja Chaves e modo teste.

Passo a passo

1. Guarde a chave como segredo

   No Lovable, abra a área de segredos do projeto (Secrets) e crie ONESENDZ_API_KEY com a chave de teste. Nunca cole a chave no código da página: quem abrir o site conseguiria ver.

2. Cole o pedido

   Adapte a primeira linha ao que o seu app precisa e cole no chat do Lovable:

   textoCopiar

   Quero que o app mande uma mensagem de WhatsApp quando [o que acontece no seu app].
   Use a API da OneSendz. Antes de escrever código, leia as regras em https://dev.onesendz.com/llms.txt
   e a especificação em https://dev.onesendz.com/openapi.json.
   A chave está no segredo ONESENDZ_API_KEY (é de teste: os envios são simulados).
   Faça a chamada numa função de servidor (Edge Function), nunca no código da página.
   Para avisos (confirmação, lembrete), use enviar_template com um template aprovado.
   Em todo envio, use uma chave_idempotencia única por mensagem.

3. Escolha o template

   Fora da janela de 24 horas, o WhatsApp só aceita templates aprovados. Peça ao Lovable para listar os disponíveis com listar_templates e usar o certo, com as variáveis na ordem.

4. Receba as respostas (opcional)

   Para saber quando o cliente responde ou quando a mensagem não chega, peça uma função pública que receba webhooks e confira a assinatura:

   textoCopiar

   Crie uma função pública que receba os webhooks da OneSendz, confira a assinatura
   (X-OneSendz-Signature, com o segredo ONESENDZ_WEBHOOK_SECRET) e salve no banco
   as mensagens recebidas e os status de envio. Depois cadastre o endereço dela com criar_webhook
   para os eventos mensagem.recebida, mensagem.entregue e mensagem.falhou.

5. Teste e vá para produção

   Com a chave de teste, os envios aparecem como enviados, mas nada chega a ninguém. Quando tudo estiver certo, crie uma chave de produção (osz_) e troque o segredo.

Exemplos do que dá para fazer

• App de agenda: confirmar o horário assim que o cliente marca e lembrar um dia antes.
• Loja ou delivery: avisar que o pedido saiu e quando chegou.
• Sistema de cursos: mandar o acesso logo depois da compra.
• Atendimento: mostrar no seu painel as mensagens que os clientes mandam.

Perguntas frequentes

Leia também