DOCS

Webhooks

Escuche eventos con webhooks

Reciba notificaciones de eventos en tiempo real para su integración con Zonos.

Los webhooks ofrecen una forma de que Zonos notifique de forma proactiva a sus sistemas externos cada vez que ocurren determinados eventos. Cuando se produce el evento suscrito, Zonos enviará una solicitud HTTP POST a la URL del webhook que usted especifique. El cuerpo de la solicitud contendrá los detalles del evento, lo que permitirá a su sistema gestionarlo de forma programática.

Los webhooks son útiles para integrar Zonos con otras plataformas, activar flujos de trabajo automatizados y mantener los datos sincronizados entre sistemas en tiempo real. Por ejemplo, podría usar webhooks para:

  • Actualizar su sistema de gestión de pedidos cuando se crea un pedido en Zonos
  • Notificar a su proveedor de cumplimiento cuando se cancela un envío
  • Registrar cambios de estado de pedidos internacionales con fines de auditoría

Tipos de webhook 

Todos los tipos de webhook disponibles se incluyen en el enum WebhookType. Los payloads de ejemplo de cada uno se encuentran en nuestra guía de Tipos de eventos.

Creación de webhooks 

Para crear un webhook mediante la API:

1mutation WebhookCreate($input: WebhookCreateInput!) {
2 webhookCreate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Edición de detalles del webhook 

Para editar un webhook existente mediante la API:

1mutation WebhookUpdate($input: WebhookUpdateInput!) {
2 webhookUpdate(input: $input) {
3 id
4 url
5 type
6 status
7 }
8}

Visualización de registros de webhook 

Para ver los registros de webhook mediante la API:

1query WebhookLogs(
2$first: Int
3$after: String
4$filter: WebhookLogsFilterInput
5) {
6 webhookLogs(first: $first, after: $after, filter: $filter) {
7 edges {
8 node {
9 id
10 type
11 url
12 createdAt
13 responseStatus
14 }
15 }
16 }
17}
GraphQL API ReferenceTypes, inputs, and operations used in this guide

¿Fue útil esta página?