API de Webhooks

Descripción General

Los webhooks son llamadas HTTP que Talk2sync dispara cuando ocurren eventos específicos en tu plataforma integrada. Tu aplicación personalizada recibe solicitudes POST en tiempo real con datos de eventos, permitiéndote sincronizar productos, órdenes y otra información crítica.

Cómo Funcionan los Webhooks

  1. Ocurre un evento en Talk2sync (actualización de producto, creación de orden, etc.)
  2. Talk2sync envía una solicitud HTTP POST a tu endpoint configurado
  3. Tu aplicación recibe y procesa los datos del evento
  4. Tu aplicación responde con una confirmación

Este es un patrón de integración reactivo donde tu sistema responde a cambios iniciados por Talk2sync.

Características Clave

CaracterísticaDetalles
ProtocoloSolicitudes HTTP POST
FormatoJSON
AutenticaciónToken portador (ver Quick Start)
Timeout1 minuto por solicitud
FrecuenciaTiempo real, a medida que ocurren eventos
ConfiabilidadEnviado una vez por evento

Cuándo Usar Webhooks

Los webhooks son ideales cuando:

  • ✓ Necesitas sincronización en tiempo real de productos u órdenes
  • ✓ Prefieres que Talk2sync te envíe los cambios
  • ✓ Tu sistema puede responder rápidamente a eventos entrantes
  • ✓ Quieres minimizar la latencia en la sincronización de datos

Cuándo Usar API de Invocación Inversa en su Lugar

Considera la API de Invocación Inversa cuando:

  • Quieras controlar cuándo ocurre la sincronización
  • Tu sistema tiene horarios de actualización específicos
  • Prefieras consultar cambios periódicamente
  • Necesites más control sobre el proceso de sincronización

Webhooks Disponibles

Productos

Gestiona tu catálogo de productos a través de webhooks:

Órdenes

Gestiona tus órdenes de venta a través de webhooks:

Flujo de Solicitud/Respuesta

Solicitud de Talk2sync a tu Endpoint

POST /api/products
Host: www.example.com
Authorization: Bearer {TU_CLAVE_GENERADA}
Content-Type: application/json

{
  "event": "product.created",
  "data": {
    // Datos específicos del evento
  }
}

Respuesta de tu Endpoint

Tu endpoint debe responder dentro de 1 minuto con:

{
  "status": "success",
  "message": "Datos procesados exitosamente"
}

Códigos de Estado HTTP:

  • 200 OK - Solicitud procesada exitosamente
  • 400 Bad Request - Datos de solicitud inválidos
  • 401 Unauthorized - Clave de seguridad inválida o faltante
  • 500 Internal Server Error - Error del servidor

Autenticación

Todas las solicitudes de webhook desde Talk2sync incluyen tu clave de seguridad en el encabezado Authorization como un token portador. Tus endpoints deben:

  1. Extraer el token del encabezado
  2. Validar que coincida con tu clave generada
  3. Rechazar solicitudes con claves inválidas o faltantes
  4. Incluir la misma clave en tu respuesta

Para implementación detallada, ver Generar Claves.

Comenzar

  1. Asegúrate de que tus endpoints estén configurados (ver Configurar Conexión)
  2. Tu clave de seguridad está generada (ver Generar Claves)
  3. Selecciona los webhooks que quieras implementar de la lista anterior
  4. Revisa la documentación detallada para cada webhook
  5. Implementa los controladores de solicitud/respuesta requeridos en tu aplicación

Manejo de Errores

Cuando Talk2sync envía una solicitud de webhook:

  • Si tu endpoint no responde dentro de 1 minuto, la solicitud agota el tiempo de espera
  • Talk2sync registrará el timeout como un intento fallido
  • Revisa tus registros del servidor para diagnosticar el problema
  • Asegúrate de que tu endpoint procese solicitudes eficientemente

Para solución de problemas, consulta la documentación específica del webhook o contacta al equipo de soporte de Talk2sync.

Siguientes Pasos

Elige un webhook para implementar:

Actualizado el: