Un webhook scrive un breve messaggio in un canale Discord quando succede qualcosa sul tuo server: si avvia, si ferma o va in crash, un giocatore entra o esce, oppure finisce un backup. Tutti nel canale lo vedono senza aprire il pannello. Un webhook può anche inviare a qualsiasi altro indirizzo https, per i tuoi strumenti.
Solo il proprietario di un server può impostarne i webhook. Le persone che hai invitato sul server non vedono la pagina.
1. Crea un webhook in Discord
Ti serve il permesso di gestire i webhook nel server Discord. Di solito ce l'hanno il proprietario e gli admin.
- In Discord apri Server Settings e vai su Integrations.
- Clicca su Create Webhook, dagli un nome e scegli il canale di testo in cui scrive, per esempio un canale
#server-alerts. - Clicca su Copy Webhook URL.
Discord spiega questi passaggi con le immagini nella sua guida Intro to Webhooks. Tratta l'URL del webhook come una password: chiunque lo abbia può scrivere in quel canale.
2. Aggiungilo al tuo server
- Apri il tuo server nel pannello e clicca su Webhook nel menu a sinistra.
- Clicca su Aggiungine uno, oppure su Nuovo webhook se il server ne ha già uno.
- Se vuoi, dagli un Nome. Serve solo a te e dà un'etichetta al webhook nel tuo elenco.
- Incolla l'indirizzo in URL. Deve iniziare con
https://. Quando è un webhook Discord, il pannello mostra Webhook Discord riconosciuto. - Sotto Invia quando, spunta gli eventi che vuoi (vedi sotto). Server in crash è già spuntato all'inizio, e ne serve almeno uno.
- Clicca su Crea webhook.
Gli eventi
| Evento | Quando viene inviato |
|---|---|
| Server avviato | Quando il server è attivo e pronto per i giocatori, anche dopo un riavvio. |
| Server fermato | Un arresto richiesto da qualcuno: tu, un membro del team o una pianificazione. |
| Server in crash | Il server si è fermato senza che nessuno lo chiedesse. Viene inviato uno o due minuti dopo, quando ne siamo sicuri, e dice se il server è ripartito da solo. |
| Giocatore entrato | Con il nome del giocatore, nei giochi che indicano chi è online. I giochi che indicano solo un numero dicono quanti sono. |
| Giocatore uscito | Lo stesso, quando qualcuno esce. I giocatori vengono controllati una volta al minuto mentre il server è in esecuzione. |
| Backup terminato | Dice se il backup è riuscito e quanto è grande. |
| Installazione terminata | Dopo la prima installazione o una reinstallazione. |
| Trasferimento terminato | Quando è finito lo spostamento del tuo server. |
I server Project Zomboid hanno eventi in più, letti dal log del gioco: Giocatore morto, Uccisione PvP, Azione admin, Mod aggiornato, Conto alla rovescia del riavvio iniziato e Inoltra la chat di gioco. La chat viene inviata solo se la spunti, e solo la chat generale: i sussurri e le chat di fazione e di rifugio non vengono mai inviati.
Cosa arriva
- Su Discord i messaggi arrivano da PlayNHost come brevi schede con il nome del server, cosa è successo e quando. Discord mostra l'ora nel fuso orario di chi legge.
- I messaggi riportano il nome del tuo server ma non includono mai il suo indirizzo né il suo ID, quindi possono andare in un canale pubblico. Per cambiare il nome che mostrano, rinomina il server. Vedi Come rinominare il tuo server e cambiare gli slot giocatore.
- Un giocatore non può menzionare il tuo canale con il suo nome. Un nome come
@everyonearriva come testo semplice. - Qualsiasi altro indirizzo riceve gli eventi in JSON. Vedi Per i tuoi strumenti qui sotto.
Disattiva un webhook, cambialo o eliminalo
- Usa l'interruttore sulla riga di un webhook per disattivarlo e riattivarlo. Mantiene le sue impostazioni mentre è disattivato.
- Apri il menu della riga e scegli Modifica per cambiare il nome, l'indirizzo o gli eventi, oppure Elimina per rimuoverlo. Nient'altro cambia: il tuo server continua a funzionare e il canale smette semplicemente di ricevere messaggi.
Da sapere
- Un server può avere fino a 10 webhook, per esempio uno per canale.
- Per tenere leggibile un canale, ogni webhook invia al massimo 4 messaggi al minuto e 40 all'ora. I messaggi oltre il limite vengono saltati invece di arrivare in ritardo, e il messaggio successivo dice quanti aggiornamenti precedenti sono stati saltati.
- Se il webhook viene eliminato in Discord, il pannello lo disattiva da solo la prossima volta che prova a inviare, e la riga mostra Disattivo. Crea un nuovo webhook in Discord, scegli Modifica, incolla il nuovo indirizzo, poi riattivalo.
- Non c'è un pulsante di prova. Per controllare un nuovo webhook, spunta Server avviato e riavvia il tuo server. Il messaggio arriva poco dopo che il server è pronto.
- I webhook servono per un canale che il tuo gruppo condivide. Per gli avvisi solo per te, nel pannello o via email, vedi Come gestire notifiche e preferenze.
Per i tuoi strumenti
Un indirizzo che non è un webhook Discord riceve una POST con un corpo JSON:
sourceèPlayNHost.eventsè un elenco. Ogni evento ha untype(comeserver.crashoplayer.join),server(il nome del server),at(quando è successo), untitlee untextleggibili, e un oggettodatacon i dettagli.skippedè quanti messaggi precedenti sono stati lasciati fuori dal limite qui sopra.
L'indirizzo deve usare https e puntare a un indirizzo pubblico su internet. I reindirizzamenti non vengono seguiti. I messaggi non sono firmati, quindi tieni segreto l'indirizzo stesso.
Vedi anche
- Come vedere cosa è successo sul tuo server mostra chi ha avviato, fermato o cambiato cosa, e quando.
- Come risolvere un server che non si avvia aiuta quando un avviso di crash continua a tornare.
