Webhooks (Phrase)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Disponible para

Planes Team, Professional, Business, Enterprise y Software UI/UX

Ponte en contacto con el equipo de ventas para preguntar por nuestros planes.

Los webhooks son URL arbitrarias que manejan solicitudes HTTP POST, lo que permite la notificación a sistemas de terceros sobre eventos específicos.

Phrase monitorea si se recibió correctamente una devolución de llamada de webhook. Si la recepción de un webhook falla 3000 veces, se desactiva con una notificación enviada a los administradores de la cuenta y el fallo se registra en el webhook específico en la página Webhooks. El mecanismo de reintento tiene un máximo de 10 reintentos, con el intervalo entre reintentos calculado hasta un valor máximo de 30 minutos.

Los webhooks se pueden desactivar/activar, mostrar el historial, probar o eliminar desde la página de webhooks seleccionando el webhook individual para mostrar la barra de herramientas. La función Historial proporciona una descripción general de las llamadas durante los 14 días anteriores y los webhooks fallidos se pueden volver a ejecutar.

Importante

La inclusión en listas blancas de conexiones de webhook por direcciones IP quedó obsoleta y ha sido reemplazada por tokens de seguridad de webhook.

Los webhooks se pueden seleccionar para los siguientes eventos:

Job status changed
Trabajo creado
Job assigned
La fecha de entrega del Trabajo ha cambiado
Fuente del trabajo actualizada
Meta del trabajo actualizada (se refiere a la acción Actualizar meta en trabajos)
Trabajo continuo actualizado

Se activa cuando el archivo fuente de un trabajo continuo se actualiza a través de un repositorio monitoreado por un conector. No se activa para una acción manual de Actualizar fuente en un trabajo regular (no continuo).
Proyecto creado
Estado del proyecto cambiado
La fecha de entrega del Proyecto ha cambiado
Plantilla del proyecto creada
Plantilla del proyecto cambiada
Plantilla del proyecto eliminada
Shared project assigned
Metadatos del proyecto actualizados
Pre-traducción terminada
Se ha creado el análisis
Trabajo eliminado
Proyecto eliminado
Trabajo exportado
Trabajo no exportado
Importación de Language AI finalizada
Traducción del lenguaje AI terminada

Configurar webhooks

Para configurar webhooks, sigue estos pasos:

En la página Configuración , baja hasta la sección Integraciones y haz clic en Webhooks.

Se abre la página Webhooks.
Haz clic en Agregar webhook o Nuevo.

Se abre la página Crear nuevo webhook.
Proporcione un nombre, una URL y un identificador único (token) de seguridad si es necesario.

Especifique un valor para incluirlo en el encabezado x-memsource-identificador único (token) o en el encabezado Authorization, que permita al usuario seleccionar su método preferido para autenticar al remitente del webhook.
Seleccionar eventos.
Haga clic en Vista previa del esquema para ver la respuesta del webhook al ejecutarse.
Haga clic en Crear webhook.

El webhook se añade a la lista en la página Webhooks.

Ejemplos de uso de webhook

Un sitio web llamado RequestBin proporcionará una URL para usar al crear un webhook.

La próxima vez que el estado del trabajo cambie o se cree un trabajo en la cuenta, la URL recibirá la respuesta adecuada del sistema. El uso real puede ser más complejo y la recepción de la respuesta debe considerarse una señal para que la aplicación conectada realice determinadas acciones.

Eventos

Ejemplos de un cambio de estado del trabajo, una asignación de trabajo, creación de trabajo y cuando la fecha de entrega de un trabajo ha cambiado.

El estado del trabajo ha cambiado

{
"jobParts": [
  {
    "id": 9,
    "uid": "ipmdz5p0sagqcOYaijTZU2",
    "internalId": "4",
    "task": "SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel": 1,
    "status": "NEW",
    "wordsCount": 2,
    "beginIndex": 0,
    "endIndex": 1,
    "isParentJobSplit": false,
    "dateDue": null,
    "dateCreated": "2016-11-02T17:06:54Z",
    "project": {
      "id": 2,
      "uid": "4RvyVbwX00KerkomA7kpT9",
      "lastWorkflowLevel": 1
    },
    "assignedTo": [
      {
        "vendor": {
          "id": 1,
          "name": "Abc",
          "vendorToken": "4-ifos0-CAqPo"
        }
      },
      {
        "linguist": {
          "id": 3,
          "firstName": "Admin",
          "lastName": "Admin",
          "userName": "admin",
          "email": "admin@example.com",
          "role": "ADMIN",
          "timezone": "Europe/London",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated": "2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event": "JOB_STATUS_CHANGED"
}

Trabajo asignado

{
"jobParts": [
  {
    "id": 9,
    "uid": "ipmdz5p0sagqcOYaijTZU2",
    "internalId": "4",
    "task": "SEfSaenvqFgctE1I0_dc1",
    "fileName": "en.txt",
    "targetLang": "af",
    "workflowLevel": 1,
    "status": "NEW",
    "wordsCount": 2,
    "beginIndex": 0,
    "endIndex": 1,
    "isParentJobSplit": false,
    "dateDue": null,
    "dateCreated": "2016-11-02T17:06:54Z",
    "project": {
      "id": 2
      "uid": "4RvyVbwX00KerkomA7kpT9",
      "lastWorkflowLevel": 1
    },
    "assignedTo": [
      {
        "vendor": {
          "id": 1,
          "name": "Abc",
          "vendorToken": "4-ifos0-CAqPo"
        }
      },
      {
        "linguist": {
          "id": 3,
          "firstName": "Admin",
          "lastName": "Admin",
          "userName": "admin",
          "email": "admin@example.com",
          "role": "ADMIN",
          "timezone": "Europe/London",
          "active": true,
          "deleted": false,
          "terminologist": false,
          "dateCreated": "2016-10-11T07:43:22Z"
        }
      }
    ]
  }
],
"event": "JOB_ASSIGNED"
}

Trabajo creado

{
 "jobParts": [
   {
     "id": 9,
     "uid": "ipmdz5p0sagqcOYaijTZU2",
     "internalId": "4",
     "task": "SEfSaenvqFgctE1I0_dc1",
     "fileName": "en.txt",
     "targetLang": "af",
     "workflowLevel": 1,
     "status": "NEW",
     "wordsCount": 2,
     "beginIndex": 0,
     "endIndex": 1,
     "isParentJobSplit": false,
     "dateDue": null,
     "dateCreated": "2016-11-02T17:06:54Z",
     "project": {
       "id": 2,
       "uid": "4RvyVbwX00KerkomA7kpT9",
       "lastWorkflowLevel": 1
     },
     "assignedTo": [
       {
         "vendor": {
           "id": 1,
           "name": "Abc",
           "vendorToken": "4-ifos0-CAqPo"
         }
       },
       {
         "linguist": {
           "id": 3,
           "firstName": "Admin",
           "lastName": "Admin",
           "userName": "admin",
           "email": "admin@example.com",
           "role": "ADMIN",
           "timezone": "Europe/London",
           "active": true,
           "deleted": false,
           "terminologist": false,
           "dateCreated": "2016-10-11T07:43:22Z"
         }
       }
     ]
   }
 ],
 "event": "JOB_CREATED"
}

La fecha de entrega del trabajo ha cambiado

{
  "jobParts": [
    {
      "ID": 127865777,
      "uid": "ElTXvXnNIHEN2xgL5sU2L2",
      "internalId": "1",
      "task": "LvkAHilgobApeoVm_dc4",
      "fileName": "EU White Paper Edited.doc",
      "targetLang": "de",
      "workflowLevel": 1,
      "status": "NEW",
      "wordsCount": 204,
      "beginIndex": 0,
      "endIndex": 16,
      "isParentJobSplit": false,
      "dateDue": "2018-09-11T22:00:00Z",
      "dateCreated": "2018-09-10T06:25:41Z",
      "project": {
        "ID": 12277756,
        "uid": "4RvyVbwX00KerkomA7kpT9
        "lastWorkflowLevel": 1
      },
      "assignedTo": []
    }
  ],
  "event": "JOB_DUE_DATE_CHANGED"
}

Tabla de estado

Al trabajar con API, Webhooks y la interfaz de usuario, el estado puede tener un nombre ligeramente diferente.

API REST	Webhook	UI
NEW	NEW	NUEVO
ACCEPTED	ASSIGNED	ACEPTADO (por el proveedor)
DECLINED	DECLINED_BY_LINGUIST	RECHAZADO (por proveedor)
REJECTED	REJECTED_BY_LINGUIST	RECHAZADO (por el proveedor)
DELIVERED	COMPLETADO	ENTREGADO
EMAILED	EMAILED	ENVIADO POR CORREO ELECTRÓNICO (por el proveedor)
COMPLETED	COMPLETED_BY_LINGUIST	COMPLETADO (por el proveedor)
CANCELLED	CANCELLED	CANCELLED