---
name: URA Reversa - modulo de campanhas VoIP programaveis
description: Sistema de campanhas URA reversa (TTS dinamico + DTMF + disparo em massa). Infra isolada do cobranca_api.py. Bugs ja corrigidos. Trunk dinamico em desenvolvimento.
type: project
originSessionId: cb486933-f159-41f1-8bb7-f110a95c9e0f
---
## Status: EM PRODUCAO desde 2026-04-20 (sistema.gotechbr.com.br/ura-campanhas)

### Arquitetura - TUDO ISOLADO da cobranca

**Magnus (69.197.165.194):**
- `ura_api.py` porta **8881** (independente do cobranca_api.py 8880 — usuario fez questao)
- AGI: `/var/lib/asterisk/agi-bin/ura_callback.sh` (callback HTTP do Asterisk)
- Audio: `/var/lib/asterisk/sounds/ura/` (asterisk:asterisk)
- Preview WAVs: `/home/customer/ura_preview/` (servidos via GET /preview/<file>)
- Sudoers: `/etc/sudoers.d/customer_ura` (permite bash, tee, asterisk reload — alem dos cp/chown/mv/rm do customer_cobranca)
- Cron @reboot auto-start
- Auto-restart NAO funciona via systemctl — usar `nohup python3 /home/customer/ura_api.py > /tmp/ura_api.log 2>&1 < /dev/null & disown`

**Intranet (sistema.gotechbr.com.br):**
- Controller `UraCampanhas` (CRUD + preview TTS + importar CSV + disparar/pausar/cancelar)
- Controller `CronUraCampanhas` (processador com flock anti-overlap)
- 4 Models: UraCampanhaModel, UraDestinatarioModel, UraDtmfModel, UraLigacaoLogModel
- Views auto-contidas em `app/Views/ura_campanhas/` (index/form/detalhe) — carregam jquery+bootstrap+metisMenu manualmente porque nao usam layout padrao
- 4 tabelas: ura_campanhas, ura_destinatarios, ura_dtmf, ura_ligacao_log
- 6 permissoes grupo "URA Reversa": ver_campanhas, criar_campanha, disparar_campanha, importar_lista, ver_relatorios, gerenciar
- Cron `*/1 9-19 * * *` chama `/cron/ura-campanhas/processar?token=58253...`
- Menu duplicado: aparece em **Telefonia** (subTelefonia) e em **OPERACIONAL**

### Token URA = mesmo do .env prod
`58253c6ba4027c651b51eb7c47ea5a6ce9eae2efa0a9fc46a3ec58794a3fb2b3` (env: CRON_TOKEN_SECRETO).
ura_api.py tem hardcoded — nao usar 741e... do fallback.

### Tunings aplicados pelo usuario
- Batch: **20 destinatarios** por execucao (era 5)
- Intervalo padrao entre disparos: **30 segundos** (era 5)
- Max intervalo: **300s** (era 60)
- Lock `flock` em `writable/tmp/ura_cron.lock` previne overlap quando batch ainda rodando
- Requeue: destinatarios em "ligando" > 2 min voltam pra "pendente" (ate atingir max_tentativas, ai vira "nao_atendida")

### Bugs ja corrigidos (NAO regredir)

1. **Permission denied ao gerar TTS**: `customer` nao escreve em `/var/lib/asterisk/sounds/ura/`. Fix: gerar em `/tmp/<audio>.wav` + `sudo cp + sudo chown asterisk:asterisk`. NAO mudar dono do dir.

2. **403 Unauthorized IP no trunk SIP**: formato Channel estava errado. Correto: `SIP/ILIMITADO_FIXO_PADRAO/10103516#<numero>` (prefixo `10103516#` eh fixo do trunk no provedor — copiar do cobranca_api.py).

3. **Congestion (circuits busy)**: telefone precisa de **`0` antes do DDD** (ex: `031987621248`, nao `31987621248`). Mesma normalizacao do cobranca:
   ```python
   tf = telefone.replace("+", "").replace(" ", "").replace("-", "")
   if not tf.startswith("0"): tf = "0" + tf
   ```

4. **Mixed Content no preview**: HTTPS prod nao carrega audio HTTP da 8881. Fix: controller `UraCampanhas::previewTts` baixa o WAV server-side (curl) e serve via HTTPS proprio em `/ura-campanhas/preview-audio/<file>`. Usa curl, NAO `file_get_contents` (allow_url_fopen off no cPanel).

5. **Menu sidebar nao funcionava nas views URA**: views sao auto-contidas (igual mensagens_agendadas), precisam carregar manualmente: jquery.min.js + bootstrap.bundle.min.js + metisMenu.min.js + simplebar.min.js + waves.min.js + app.js.

### MagnusBilling - trunks disponiveis

Banco MySQL local no Magnus: `mbilling`
- Credenciais: `mbillingUser` / `pvdDa1xpYkQ0rF5T` (em `/etc/asterisk/res_config_mysql.conf`)
- Tabela `pkg_trunk` tem 16 trunks ativos (status=1)
- Trunk principal cobranca/URA: `ILIMITADO_FIXO_PADRAO` prefix `10103516#` (mas pkg_trunk diz prefix `1011#` — o valor real usado eh `10103516#` que vem da config Asterisk, nao da tabela)
- Endpoint URA api: `GET /trunks?token=XXX` retorna lista (usa `mysql` CLI via subprocess porque pip3 esta quebrado por bug OpenSSL)

### Pendente (paralisado pra resolver bug PDFs cobranca)
- Frontend: dropdown de trunk no form da campanha
- Schema: ALTER TABLE ura_campanhas ADD COLUMN trunk_code, trunk_prefix, caller_id_nome, caller_id_numero
- CronUraCampanhas: passar trunk_code/prefix/caller_id no payload pro Magnus
- handle_ligar do ura_api.py JA aceita trunk_code/trunk_prefix/caller_id (fallback pro padrao se vazio)

### Como rodar manualmente
```bash
# preview
curl -X POST http://69.197.165.194:8881/ura/preview \
  -H 'Content-Type: application/json' \
  -d '{"token":"58253...","texto":"Teste","voz":"pt-BR-FranciscaNeural"}'

# listar trunks
curl 'http://69.197.165.194:8881/trunks?token=58253...'

# resetar destinatario travado
mysql ... -e "UPDATE ura_destinatarios SET status='pendente', tentativas=0, uid_ligacao=NULL WHERE id=X"

# forcar ciclo do cron
curl 'https://sistema.gotechbr.com.br/cron/ura-campanhas/processar?token=58253...'
```

### Arquivos de codigo no projeto
- Backups locais: `D:\xampp\htdocs\intranet\docs\ura_api.py`, `ura_callback.sh`, `customer_ura_sudoers`, `ura_setup.sql`
- Doc: `D:\xampp\htdocs\intranet\docs\ura_api_magnus.md` (referencia inicial — abordagem foi mudada para arquivo separado)