Painel Criador de Mensageria

Identificação

O slug vira nome do container, do banco, da unit systemd e do workspace Terraform.

Slug * minúsculas, 3–32 chars, começa com letra

Título *

Onde o projeto vai nascer * cadastre VPS na aba Servidores

URL pública (derivada do slug) um domínio só, compartilhado; o que separa cada projeto é o path

WTS Chat — o que muda a cada cliente

Tudo aqui sai do painel da WTS do cliente. São os únicos valores que não dá para adivinhar: token, de qual número sai a mensagem, quais templates são disparados e quais tags marcam o contato.

API Token * WTS → Configurações → API. Autentica todas as chamadas; começa com pn_

Channel ID * WTS → Canais. É de qual número de WhatsApp a mensagem sai — o número não fica no código, vem daqui

Template de lembrete * O template aprovado que avisa o paciente. Precisa ter os campos [Paciente] e [AGCompleto]

Template de entrega de exame * Disparado quando o ERP manda EntregaExame. Precisa ter [NOMEEXAME]

Tag “Confirmar” * WTS → Tags. Marca o contato quando o paciente confirma

Tag “Desmarcar / Remarcar” * Remarcar e desmarcar usam a mesma tag, por design

Tag “Cancelar” * Marca o contato quando o paciente cancela

ERP — para onde a resposta volta

Quando o paciente responde, o app classifica e devolve o resultado ao sistema do cliente.

URL de callback do ERP * Endpoint que recebe a resposta classificada. O app faz 1 POST por procedimento (o Otimus exige assim)

Avançado — tudo já resolvido; abra só se precisar fugir do padrão

Portas, senha do banco e diretório são alocados automaticamente sem colidir com projetos existentes. Timezone e nível de log seguem o padrão da casa. Deixe em branco.

Ambiente

Timezone usado nos crons de limpeza e reset diário

Nível de log use debug só para investigar um problema

Base URL da API WTS só muda em ambiente de homologação da WTS

Alocação (em branco = automático)

Porta do app livre agora: —

Porta do Postgres livre agora: —

Senha do Postgres mín. 12 caracteres se você informar

Diretório na VPS

Langfuse — rastreamento dos grafos (opcional)

Secret key em branco desabilita o tracing, sem custo algum

Public key só ativa se as duas chaves forem preenchidas

Base URL

Domínio próprio (fora do padrão)

Domínio dedicado só preencha se este projeto tiver subdomínio próprio em vez do path — exige vhost e certificado à parte na borda

E-mail do certificado usado só no caso acima, pelo certbot

O que o pipeline vai fazer

1. gerar o projeto a partir do template → 2. terraform apply (rede, volume e Postgres na VPS) → 3. ansible (Bun, schema, systemd, nginx, SSL) → 4. testes unit + integração + smoke

pular emissão de SSL (DNS ainda não propagou) rodar testes automatizados ao final

Projetos

Cada linha é uma mensageria numa VPS.

Slug	Título	Servidor	Domínio	Portas	Status	Ações
carregando…

Cadastrar VPS

Onde os projetos podem nascer. O painel precisa de SSH com chave, Docker instalado e sudo sem senha (ou usuário root).

Nome * identificador curto, sem espaços

Provedor

Host / IP *

Usuário SSH

Porta SSH

Chave privada SSH caminho no disco do painel; vazio usa o agente SSH

Diretório base dos projetos

Domínio base só para sugerir subdomínio na criação

Observações

VPS cadastradas

Use "Checar" antes de criar um projeto — valida SSH, Docker e sudo.

Nome	Provedor	Endereço	Base	Último check	Ações
carregando…

Testes automatizados

unit — lógica pura (classificação, agrupamento, telefone, textos) • integração — repositórios contra o Postgres real do projeto • smoke — HTTP ponta a ponta contra o app no ar, sem disparar WhatsApp real.

Execuções

Toda etapa do pipeline vira uma execução com saída completa.

atualizar automaticamente

#	Etapa	Status	Início	Duração	Comando
carregando…

🏭 Painel Criador de Mensageria