WooCommerce
El conector nativo con webhooks firmados, el campo de consentimiento del checkout y el snippet que hace viajar el token del enlace hasta el pedido.
En esta página
WooCommerce es integración nativa: la tienda firma cada webhook con un secreto que genera esta plataforma — tú solo lo pegas. Los pedidos entran con verificación criptográfica, sin token en la URL.
La tarjeta está en la app, en Ajustes → Integraciones → WooCommerce.
Conectar
- En la tarjeta de WooCommerce, pulsa Generar secreto y cópialo. Se muestra una sola vez.
- Copia también la URL del webhook de la tarjeta.
- En tu tienda: WooCommerce → Ajustes → Avanzado → Webhooks → Añadir webhook.
- Nombre libre · Estado Activo · Tema Pedido actualizado · URL de entrega = la URL copiada · Secreto = el secreto copiado · API v3.
- Guarda y haz un pedido de prueba. La actividad de la tarjeta debe reflejarlo en unos segundos.
- Opcional: en la tarjeta, ajusta el prefijo telefónico (34 para España), la etiqueta automática, el campo de consentimiento del checkout y los estados que cuentan como pago.
El campo de consentimiento del checkout
El «Campo de consentimiento del checkout» de la tarjeta es el nombre del meta del pedido donde tu tienda guarda la casilla (por ejemplo con Checkout Field Editor). Ese meta es lo que la plataforma lee como consent — y es lo que decide el nivel del contacto.
| Situación | Base registrada | Opt-in resultante | Qué puede recibir |
|---|---|---|---|
| Meta configurado y la casilla marcada | checkbox | Marketing | Todo: campañas, oleadas, automatizaciones de order.paid y plantillas 1. Levanta una baja anterior (acto explícito del cliente). |
| Meta configurado y el pedido lo trae con valor falso | — (no se registra alta) | Sin cambios | La venta se registra solo si ya era contacto dado de alta; si no, no se crea perfil. |
| Campo de consentimiento VACÍO en la tarjeta — o configurado pero el pedido no trae ese meta | purchase | No | Solo respuestas cuando la persona escribe. La automatización de order.paid NO se envía. Una baja anterior se respeta siempre. |
Vincular la venta con el enlace que la trajo
Opcional, pero es la única forma de atribuir una venta cuyo teléfono no reconocemos.
Los enlaces que envía la plataforma añaden ?wtk=<token> a la URL de destino. WooCommerce no lo guarda por su cuenta: hace falta este fragmento en tu tienda para que el token viaje hasta el pedido. Con él, un pedido cuyo teléfono no reconocemos se puede seguir atribuyendo al contacto que recibió el enlace (aparece como «vía enlace»).
Pégalo en el functions.php de tu tema hijo, o en un plugin de snippets:
// Konverda — vincula la venta con el enlace que la trajo.
add_action( 'init', function () {
if ( isset( $_GET['wtk'] ) && ! headers_sent() ) {
$wtk = substr( sanitize_text_field( wp_unslash( $_GET['wtk'] ) ), 0, 64 );
if ( $wtk !== '' ) {
setcookie( 'wtk', $wtk, time() + 30 * DAY_IN_SECONDS, COOKIEPATH ?: '/', COOKIE_DOMAIN, is_ssl(), true );
}
}
} );
add_action( 'woocommerce_checkout_create_order', function ( $order ) {
if ( ! empty( $_COOKIE['wtk'] ) ) {
$order->update_meta_data( 'wtk', substr( sanitize_text_field( wp_unslash( $_COOKIE['wtk'] ) ), 0, 64 ) );
}
}, 10, 1 );
Seguir leyendo
- El opt-in de marketing y «Añadir a marketing»
- La baja y qué recuerda la plataforma
- API de pedidos (conexión genérica) — el camino para todo lo que no sea Woo.
¿No lo has resuelto? Contactar soporte