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 fully translated – a file is translated into one of the target languages
• File fully reviewed – translations in a file are approved for one of the target languages
• File added
• File updated
• File reverted
• File deleted
• Project fully translated – all files are translated into one of the target languages
• Project fully reviewed – translations in all files are approved for one of the target languages
• Project successfully built
• 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
• String comment/issue created
• String comment/issue updated
• String comment/issue deleted
• String comment/issue restored
• Task added
• Task status changed
• Task deleted

Webhook Payload Examples

Visit Webhooks acticle on Crowdin Developer Portal.

Aggiungere Webhook

Per configurare i webhook su Crowdin, apri il tuo progetto e vai a Integrazioni > Webhook. Clicca Aggiungi Webhook per iniziare a configurare il tuo nuovo webhook.

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).
• Il tipo di contenuto per il metodo di richiesta POST (multipart/form-data, application/json, o 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 Prova per visualizzare come la tua applicazione reagirà a quella chiamata.

A seconda del tuo approccio alla gestione dei webhook, potresti dover aggiungere gli indirizzi IP di Crowdin dedicati al tuo firewall, per consentire a Crowdin di aprire gli URL del webhook pre-configurato.

Read more about IP Addresses.

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 della Cronologia delle Chiamate puoi visualizzare l’elenco delle chiamate di tutti i webhook aggiunti al progetto. Usa il filtro per visualizzare tutte o solo le notifiche del webhook fallite.

Cercare Assistenza

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