Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Setup "Admin" callback

These callback URLs are called with all events in the Beebox.

...

The URL will be called for all events.

Setup "Connector" callback

Introduction

Connector callbacks are only triggered when translations have been completed and are ready for download (using the API).

Use case: When you link a CMS with the Beebox, the CMS uses the limited "Connector" credentials to exchange work. If you would like to notify the CMS of work completed you may want to have a specific CMS page be called. That page may then notify a CMS user or trigger the download of translations.

Setup

Connector callbacks are configured in the "CMS Connector" tab of the project "Settings" page:

...

This URL will be called for the event "CreatedTranslatedFiles" only. See list of all events.

Webhook

The URL that you configure above will be called whenever a translated file or a batch of translated files is "delivered". This means that the translated file was added or updated in the "out" directory. It can then be pulled by API or FTP. With the example in above screenshot, the URL being called might be:

...

  • bbproject: Is the Beebox project ID. This is the same ID used by the connector to authenticate.
  • bbid: This is a unique ID for the operation. Use the API to obtain the details such as the list of delivered files.
  • bbok: Indicates "yes" if the delivery operation was successful and "no" if it failed.
  • bberror: Only available if the operation failed: A string with a short error message, in case the operation failed.

Operation details

With the bbid value you can now connect to the Beebox project and fetch all the details for the delivered files.

...