Capítulo 2 de 5
Capítulo 2 de 5
Webhooks firmados
Un webhook avisa a otra aplicación en cuanto pasa algo en tu tienda, como una venta, un reembolso o una suscripción cancelada. Con la API, tu programa pregunta. Con un webhook, tu tienda avisa sin que nadie pregunte. Cada aviso va firmado para que el destino compruebe que viene de OnBio.
Registra un webhook
- 1. En Integraciones, pulsa Nuevo webhook.
- 2. Pega en Dirección la que te da la otra aplicación.
- 3. Elige los Eventos que quieres recibir y pulsa Guardar.
- 4. Copia el secreto de firma y guárdalo en el destino.
La dirección tiene que empezar por https://. El secreto solo se ve al crear el webhook. Puedes tener hasta 20 webhooks por tienda.
Los eventos
Puedes recibir las ventas, los reembolsos, las suscripciones nuevas y canceladas, los leads, los accesos concedidos y retirados y las facturas. Elige solo los que tu destino va a usar.
Prueba el destino
- 1. Pulsa Ver entregas en la fila del webhook.
- 2. Pulsa Enviar evento de prueba.
- 3. Comprueba en Entregas que la prueba aparece como Entregada.
La firma
Cada entrega lleva una firma calculada con el secreto. El destino la recalcula y la compara antes de fiarse del aviso. El código para verificarla está en la referencia para desarrolladores. Si pierdes el secreto, pulsa Rotar secreto y pon el nuevo en el destino.
Si el destino falla
Si el destino no responde, OnBio reintenta hasta 8 veces con esperas crecientes. Si todas fallan, la entrega queda como Sin enviar. Cuando el destino vuelva a responder, pulsa Reenviar las entregas sin enviar. Cada una sale con su identificador de evento original para que el destino reconozca las que ya tenía.
Si las entregas fallan muchas veces seguidas, OnBio desactiva el webhook y te avisa. Lo explica mi webhook está desactivado.
Qué tienes ya
Tu tienda avisa a tus herramientas al momento. En el siguiente capítulo automatizas con Zapier.
¿Te ha servido?
¿Necesitas hablar con nosotros?
Si no has encontrado lo que buscabas, escríbenos. Contestamos en dos días laborables.