WhatsApp no Bolt: Secrets do banco, função de servidor e checagem antes do envio

Passo a passo

1. 1

   Conecte um banco ao projeto

   Na documentação, a aba Secrets exige um banco conectado ao projeto. Conecte o banco antes de continuar.

2. 2

   Salve as chaves em Secrets

   Clique no ícone do banco no menu superior, abra Secrets, e salve ZAPZAP_API_KEY, ZAPZAP_API_SECRET e ZAPZAP_INSTANCE_ID. O nome é sensível a maiúsculas e minúsculas. Em conta individual só o dono vê os secrets; em conta de equipe, dono, co-donos e administradores. Chaves em Settings > API de app.zapzapapi.com.

3. 3

   Peça a função de servidor

   Prompt: "Crie uma função de servidor que recebe number e text, chama POST /chat/check da ZapZap com numbers: [number], e só se o número existir chama POST /send/text. Leia ZAPZAP_API_KEY, ZAPZAP_API_SECRET e ZAPZAP_INSTANCE_ID dos secrets. O front só chama essa função."

4. 4

   Revise o que o Bolt gerou

   Procure por três erros comuns: chave escrita no código, chamada feita pelo componente do front e envio sem validar o número. Corrija pedindo ao Bolt, e compare com o exemplo desta página.

5. 5

   Teste com um número seu e olhe o status da instância

   Chame a função com o seu telefone, confira a resposta e consulte GET /{instanceId}/instance/status. Se a instância estiver desconectada, reconecte pelo QR code no painel.

// Server function (Deno edge function): check the number first, then send. Secrets: ZAPZAP_API_KEY, ZAPZAP_API_SECRET, ZAPZAP_INSTANCE_ID
const BASE = "https://api.zapzapapi.com/api/v1/" + Deno.env.get("ZAPZAP_INSTANCE_ID");
const headers = {
  "Content-Type": "application/json",
  "x-api-key": Deno.env.get("ZAPZAP_API_KEY") ?? "",
  "x-api-secret": Deno.env.get("ZAPZAP_API_SECRET") ?? "",
};

Deno.serve(async (req: Request) => {
  const { number, text } = await req.json();
  const check = await fetch(BASE + "/chat/check", { method: "POST", headers, body: JSON.stringify({ numbers: [number] }) });
  if (!check.ok) return new Response("check failed: " + check.status, { status: 502 });
  const found = JSON.stringify(await check.json());
  if (!found.includes(number)) return new Response("number not found", { status: 404 });
  const send = await fetch(BASE + "/send/text", { method: "POST", headers, body: JSON.stringify({ number, text }) });
  return new Response(await send.text(), { status: send.status });
});