Webhooks: sepa al instante que hay una entrada vendida

Imagine que quiere que el contador de su web se mueva en cuanto se venda una entrada. Hay dos maneras de conseguirlo, y una es bastante mejor.

Este artículo explica qué es un webhook y si lo necesita. Cómo configurar uno, botón por botón, se explica en Configurar webhooks.

El mundo al revés

Sin webhook, su web tiene que seguir preguntando. Cada minuto, todo el día: «¿ya se ha vendido algo?» Casi siempre la respuesta es no. Son mil cuatrocientas preguntas al día para oír tres veces que sí — y entre dos preguntas su contador no es correcto.

Con un webhook se da la vuelta. Usted nos da una dirección de su propia web, y en cuanto pasa algo enviamos allí un mensaje breve. Un solo mensaje, en el momento mismo.

De ahí el nombre: un hook es un gancho del que colgamos algo en cuanto llega el momento.

Qué puede hacer con ello

• mover el contador de su web en cuanto se venda algo;
• recibir un mensaje en el chat del equipo con cada pedido por encima de un importe;
• actualizar su lista de socios cuando alguien compra un abono;
• enviarse un correo cuando se anula un pedido;
• avisar enseguida a su caja o contabilidad de que ha entrado dinero.

Qué necesita

Tres cosas, y su desarrollador web conoce las tres:

1. Una dirección en su propia web capaz de recibir mensajes. Es una página normal que nadie visita; solo está para recibir nuestro mensaje. Debe empezar por https://.
2. Un sitio donde introducir esa dirección. Lo hace usted mismo, en Ajustes → Acceso API, en la pestaña Webhooks — vea Configurar webhooks. Si su desarrollador prefiere hacerlo desde su propio programa, necesita una clave con el permiso Webhooks; vea Crear una clave API.
3. El secreto que corresponde a esa dirección. Lo recibe de nosotros en cuanto la dirección está configurada, y con él su web comprueba que un mensaje viene de verdad de nosotros.

Lo tercero importa. Sin comprobar el secreto, cualquiera que adivine su dirección puede hacer creer a su web que se ha vendido algo. Con la comprobación, no.

Qué aspecto tiene

Llega un mensaje breve que dice qué ha pasado y sobre qué. Su web mira el secreto, ve que coincide, y después hace algo con ello: subir un contador, escribir una línea, enviar un correo.

Qué contiene exactamente un mensaje así, y cómo se programa la comprobación del secreto, está en el portal para desarrolladores — esa es la página que reenvía a quien lo construye.

Tres cosas que suelen salir mal

Responda rápido. Nuestro mensaje espera una respuesta diez segundos como mucho, no hasta que su web haya terminado todo su trabajo. Acepte el mensaje, diga que ha llegado, y haga el trabajo después.

Cuente con repeticiones. Si su web estuvo un momento inaccesible, lo intentamos de nuevo — hasta seis veces, repartidas a lo largo de algo más de un día y medio. Puede pasar, por tanto, que el mismo mensaje llegue dos veces. Haga que su web lo aguante — el mismo mensaje dos veces no debe producir dos veces el mismo correo.

Mantenga el secreto en secreto. Debe estar en los ajustes de su servidor, no en código que acabe en su web pública.

¿Necesita esto?

No. Un webhook es útil cuando algo tiene que ocurrir enseguida. Si basta con un resumen diario, no lo necesita — entonces llega con recoger las cifras una vez al día.

Los webhooks pertenecen al mismo plan que el resto de la API. Lo que hay en cada plan está en la página de precios de Passavo.

Siga leyendo

• Configurar webhooks — la pantalla misma: añadir una dirección, enviar un mensaje de prueba, leer el registro de mensajes.
• ¿Qué es una API, y la necesito?
• Crear una clave API
• El portal para desarrolladores — para quien construye la integración.