Webhooks

I webhook ti notificano ed aiutano a raccogliere informazioni sugli eventi chiave che avvengono nel tuo progetto di Crowdin, come le traduzioni completate o la correzione delle bozze. Dopo aver configurato un webhook per il progetto, Crowdin inizierà a inviare richieste POST o GET con i dati all’URL del webhook tramite HTTP.

Solo i proprietari e i gestori del progetto possono registrare un webhook.

Casi d’Uso

You can add webhooks to build integrations with the services or with your backend. Per esempio:

• Set up a webhook to send notifications to the system you use.
• Pass information to the third-party services with the specific request requirements (for example, HTTP method, сontent type).
• Crea integrazioni personalizzate con Crowdin.

Eventi

You can configure webhooks for the following types of events:

• File completamente tradotto

• File completamente revisionato

• Progetto completamente tradotto

• Progetto revisionato completamente

• Exported translation updated – final translation of a string is updated

• Source string added

• Source string updated

• Source string deleted

• Suggested translation added – a string in the project is translated

• Suggested translation updated – a translation for a string in the project is updated

• Suggested translation deleted – one of the translations is deleted

• Suggested translation approved – a translation for a string is approved

• Suggested translation disapproved – approval for a previously added translation is removed

• Task added

• Task status changed

• Task deleted

Aggiungere Webhook

To configure webhooks in Crowdin, open your project and go to Integrations > Webhooks. Clicca Aggiungi Webhook per avviarne la configurazione.

You will need to provide the following information to register a webhook:

• Il nome del webhook (ad esempio, “Progetto App Tradotto”).
• L’URL in cui la richiamata dovrebbe essere inviata.
• The request method that indicates the desired action to be performed for a given resource (use either GET or POST).
• The content type for the POST request method (multipart/form-data, application/json, or application/x-www-form-urlencoded).
• For the application/json content type, you can select Batch webhooks to merge multiple events into a single request.
• Gli eventi da postare all’URL. Puoi selezionare un evento o un set di eventi specifico.

Aggiungendo un webhook, clicca Test per vedere come la tua applicazione reagirà a quella chiamata.

In base al tuo approccio alla gestione dei webhook, potresti dover aggiungere indirizzi IP di Crowdin dedicati al tuo firewall per consentire a Crowdin di aprire gli URL dei webhook preconfigurati.

Leggi di più sugli Indirizzi Ip.

Sending Webhooks to Slack

Con l’aiuto dei webhook di Crowdin, puoi inviare le notifiche sui tipi di evento preconfigurati direttamente al canale di Slack specifico.

Per configurare l’invio dei webhook a Slack, dovresti creare una semplice app Slack. Leggi di più sull’Invio di messaggi a Slack usando i Webhook In Entrata.

Appena creata e configurata la tua app di Slack, dovrai avere un URL del Webhook che dovrebbe esser usato per la configurazione dei Webhook nel tuo progetto di Crowdin.

Modifica o Elimina Webhook

You can access the list of all existing webhooks within a specific project. You will be able to edit or delete webhooks right from the list of webhooks displayed.

Cronologia delle Chiamate

Nella sezione Cronologia delle chiamate puoi vedere l’elenco di chiamate di tutti i webhook aggiunti al progetto. Usa il filtro per visualizzare tutte le notifiche dei webhook o solo quelle fallite.

Cercare Assistenza

Need help working with Webhooks or have any questions? Contatta il Team di Supporto.