netgescon-day0/docs/CTI-NS1000-CHECKLIST.md

56 lines
2.4 KiB
Markdown

# CTI Panasonic NS1000 - Checklist Operativa
## 1) Endpoint NetGescon da usare
- `POST /api/v1/cti/panasonic/incoming`
- `POST /api/v1/cti/panasonic/call-ended`
- `GET /api/v1/cti/panasonic/lookup?phone=...`
Esempio base:
- `https://staging.netgescon.it/api/v1/cti/panasonic/incoming`
## 2) Cosa controllare quando non arrivano chiamate
- Rete: il centralino deve raggiungere HTTPS 443 del server NetGescon.
- DNS: host configurato nel PBX deve risolvere l'IP corretto.
- Certificato TLS: il PBX non deve rifiutare il certificato del dominio.
- Token CTI: deve combaciare con il token lato NetGescon.
- Clock/NTP: orario PBX corretto (evita problemi firma/token e log).
- Firewall: apertura uscita dal PBX verso internet/DMZ su 443.
## 3) Porta 33333 / servizi monitoraggio
- La porta `33333` su NS1000 viene spesso usata per stream eventi/integrazioni CTI legacy.
- Se usata, configurare IP sorgente autorizzati e ACL precise (mai aperta pubblicamente).
- Preferire webhook HTTPS verso NetGescon come canale primario e 33333/syslog come canale diagnostico.
## 4) Syslog NS1000 (consigliato)
- Abilitare invio syslog remoto dal PBX verso un collector interno.
- Livello consigliato: eventi chiamata + errori integrazione.
- Conservare almeno 7-14 giorni per analisi incidenti.
- Correlare timestamp syslog con log applicativi NetGescon.
## 5) Configurazione web NS1000 (traccia operativa)
1. Accedi alla Web Maintenance Console.
2. Vai su sezione integrazioni CTI/CSTA e abilita notifica eventi chiamata.
3. Imposta URL callback HTTPS di NetGescon per eventi incoming/call-ended.
4. Inserisci token condiviso (stesso valore lato NetGescon).
5. In sezione sicurezza/rete limita destinazioni consentite al solo host NetGescon.
6. In sezione log abilita syslog remoto (se disponibile) verso collector interno.
7. Salva e riavvia il servizio CTI (o applica configurazione runtime).
## 6) Test rapido post-configurazione
1. Effettua una chiamata di test entrante sul centralino.
2. Verifica che sia creato/aggiornato il Post-it chiamata in NetGescon.
3. Chiudi la chiamata e verifica aggiornamento su endpoint `call-ended`.
4. Controlla log applicativi e, se attivo, log syslog del PBX.
## 7) Opzione interno VOIP monitor
- Si puo configurare un interno tecnico di monitoraggio per ascolto/diagnostica, rispettando policy privacy.
- Usarlo solo per troubleshooting, con accesso limitato e audit.