Cosa fare se il chatbot risponde due volte in diretta

Prima determinate il tipo di duplicato

Due risposte identiche di seguito non sono un unico guasto, ma almeno due problemi diversi. Primo caso: il bot ha ricevuto un solo evento, ma due volte. Secondo: l'evento è arrivato una volta sola, ma il bot l'ha inviato due volte. Si risolvono in modi diversi, quindi non iniziate modificando il codice: partite dai log.

Aprite il registro del bot e trovate il momento del duplicato. Poi guardate due campi: l'identificatore dell'evento e l'ora di ricezione.

• Due richieste con lo stesso event_id (o message_id, notification_id — il nome dipende dalla piattaforma) e una differenza di millisecondi: è una riconsegna dello stesso evento. Cercate la deduplicazione.
• Due richieste con identificatori diversi: sul canale sono effettivamente sottoscritti due gestori. Cercate la seconda sottoscrizione.

Se non ci sono log, partite dai pannelli delle piattaforme: lì si vede chi è sottoscritto agli eventi del canale.

Come si presenta una doppia sottoscrizione nei pannelli

Le piattaforme non mostrano «bot connesso due volte» in una sola riga. Gli indizi sono sparsi in sezioni diverse.

Twitch

Controllate la sezione Connections nelle impostazioni dell'account: lì c'è l'elenco delle applicazioni collegate. Lo stesso bot può essere autorizzato sia come applicazione del canale sia come applicazione del vostro account personale. Inoltre le sottoscrizioni EventSub vivono separatamente: l'applicazione può mantenere una sottoscrizione attiva a channel.chat.message dopo che avete disattivato l'integrazione nel pannello. Anche una seconda istanza del bot avviata in locale riceve gli eventi allo stesso modo di quella in produzione.

YouTube

Qui spesso la colpa non è del bot in sé, ma dell'accesso alla chat: il bot è connesso alla diretta sia come moderatore sia come account partecipante separato. Controllate l'elenco dei moderatori e l'elenco delle applicazioni autorizzate del canale. Inoltre, se il bot funziona tramite più progetti Google Cloud, le chiavi possono passare per due percorsi diversi.

Discord

Il caso più evidente: due applicazioni con lo stesso token sullo stesso server. Entrambe vedono il messaggio nel canale ed entrambe rispondono. Controllate l'elenco dei bot sul server e assicuratevi che al canale non sia collegato un secondo webhook con lo stesso nome.

Il lato negativo di questa strada è che serve accesso non solo al bot, ma anche ai pannelli del canale. Se il canale è gestito da più persone, la seconda istanza potrebbe averla avviata qualcun altro senza che voi lo sappiate.

Ripetizione del webhook: perché l'evento arriva due volte

Il servizio esterno consegna il webhook e attende una conferma. Se non la riceve entro il tempo previsto, lo invia di nuovo. La seconda richiesta porta lo stesso evento, ma il bot la percepisce come nuova e risponde di nuovo. Questo accade a ogni blocco del server: più è alto il carico, più spesso succede.

Si risolve con la deduplicazione lato bot. Serve una chiave identica per tutte le copie di uno stesso evento e univoca per eventi diversi. La chiave si ricava dal corpo della richiesta o dagli header: dipende dall'API, ma lo schema è lo stesso.

Esempio di chiave di deduplicazione

Immaginate un webhook su una nuova donazione. Nel corpo arriva un oggetto con il campo id: il numero univoco della transazione, che non cambia alla riconsegna. La logica è questa:

1. Alla ricezione della richiesta estraete l'id dal corpo.
2. Controllate nello storage (Redis, una tabella nel database) se è già comparso nelle ultime, diciamo, ventiquattro ore.
3. Se è già comparso, rispondete al servizio «ricevuto» e non inviate nulla in chat.
4. Se no, registratelo ed elaborate come al solito.

La chiave deve venire dall'evento, non essere generata da voi: se ne generate una vostra, due consegne dello stesso evento otterranno chiavi diverse e la deduplicazione non funzionerà. Alcune piattaforme forniscono un header già pronto con l'identificatore di consegna: in quel caso usate quello, è più affidabile. Il lato negativo dell'approccio è che servono uno storage e una politica di pulizia, altrimenti la base delle chiavi cresce senza limite.

Se il duplicato arriva da due fonti diverse

Un caso a parte è quando l'evento non si ripete, ma arriva davvero da due punti. Il classico: il bot risponde a un comando sia in chat sia nell'inoltro tra piattaforme tramite un bridge. Oppure la risposta automatica è impostata su due trigger che scattano sulla stessa frase.

Questi duplicati si distinguono dalla ripetizione del webhook dai log: le richieste hanno fonti diverse (piattaforme diverse, gestori diversi), ma un unico evento concettuale. Cercate la sovrapposizione dei trigger e disattivatene uno. Per il bridge, non inoltrate di nuovo i messaggi del bot stesso.

Controlli prima della diretta

1. Inviate un comando di test e guardate quante risposte sono arrivate.
2. Disattivate tutte le integrazioni tranne una, ripetete.
3. Riattivatele una alla volta finché il duplicato non torna: così trovate il colpevole.
4. Confrontate nei log l'identificatore dell'evento delle due risposte: se è uguale è una riconsegna, se è diverso è una seconda sottoscrizione.

Se non trovate la causa, disattivate la risposta automatica sull'evento problematico e scrivete al supporto del servizio con i log e l'orario della ripetizione. Nell'attesa, gestite la chat manualmente: meglio perdere l'automazione per una serata che riempire la diretta di frasi identiche.