Deploy

Deploy

Para usar o painel hospedado, comece pelos Primeiros passos. As seções sobre runtime, fila e stores abaixo se aplicam a quem hospeda sua própria integração SDK.

Onde roda

Qualquer runtime que execute Hono: Node 18+, Cloudflare Workers, Deno, Bun. Rotas de API do Next.js são o padrão documentado.

Variáveis

Padrão .env.local para desenvolvimento local. Em produção, defina no ambiente da plataforma (Vercel, Worker Secrets). Em uma integração de servidor, use APOINTOO_TENANT_KEY se esse for o nome lido pela rota. Não exponha essa chave com NEXT_PUBLIC_. Integrações que chamam o painel diretamente do navegador têm um contrato próprio; use as instruções geradas para esse fluxo. Nunca coloque chaves de provedor de email no navegador.

Confira o projeto que serve o domínio, o ambiente de destino e os nomes exatos lidos pelo código. Salve e faça um novo deploy de cada site afetado. Editar uma variável não atualiza builds existentes. Após rotação de chave, atualize todos os consumidores. Use apenas placeholders em .env.example.

Fila e outbox

Uploads de conversão passam pela fila com outbox. Uma falha transitória do Google não derruba o confirm; a tentativa repete conforme a agenda. Sem persistência configurada, use os stores de memória apenas em desenvolvimento.

Deduplicação

Guarde a chave de idempotência junto ao registro. Um confirm repetido devolve o mesmo resultado; nada duplica no destino.

Checklist de produção

• NEXT_PUBLIC_SITE_URL aponta para o host canônico (www).
• Chaves da integração de servidor só no ambiente servidor.
• Site republicado após alterações de variáveis.
• Envio real conferido no painel; email verificado separadamente.
• Store de estado persistente configurado (não memória).
• Consentimento ativo na frente da captura.
• Webhook de revalidação ligado se você usa CMS.
• Logs de entrega acessíveis ao time que responde incidentes.