Cuenta y equipo
Conecta tu WhatsApp a trazpago a través de Crisp
Si tu número de WhatsApp Business ya trabaja en Crisp, trazpago puede enviar tus avisos a través de Crisp: tú los organizas en trazpago y Crisp los manda por WhatsApp desde el número que tus clientes ya conocen. Aquí están los pasos completos, incluido el que más se olvida: pegar en Crisp las dos direcciones que trazpago te muestra una sola vez.
Cuándo te conviene esta opción
Usa la conexión a través de Crisp cuando tu número de WhatsApp Business ya esté conectado a Crisp y sea Crisp quien pague los mensajes de ese número. En ese caso Meta admite un solo pagador por cuenta y rechaza los envíos directos de cualquier otra herramienta, trazpago incluido: al conectar de forma directa todo se ve bien, pero el mensaje de prueba no sale.
Con esta opción no cambias nada de tu arreglo con Crisp: el número, la bandeja de tu equipo y la facturación de los mensajes siguen igual. trazpago solo le entrega a Crisp lo que hay que enviar. Y conviene decirlo tal cual: esto es un canal de avisos, no de dinero. trazpago no procesa tus pagos; organiza tus cobros y sus avisos. El dinero llega directo a tu cuenta, como siempre.
Qué necesitas tener a la mano en Crisp
Antes de abrir trazpago, reúne estos datos de tu cuenta de Crisp. Para generar las credenciales necesitas ser propietario (Website Owner) del sitio en Crisp.
- Website ID: el identificador de tu sitio en Crisp. Crisp explica dónde encontrarlo en su guía Where can I find my Website ID.
- Identifier y key del plugin de WhatsApp: en Crisp ve a Plugins → WhatsApp → API Tokens y genera el par de tokens. Crisp muestra la key una sola vez: cópiala en ese momento. Si la pierdes, en API Settings del mismo plugin puedes revocar los tokens y generar unos nuevos (Crisp avisa por correo a todos los propietarios del sitio cuando eso pasa).
- Opcional: secreto de firma del Plugin Hook: solo hace falta si quieres ver en trazpago cuándo se entregó y se leyó cada mensaje. Te lo da Crisp al crear un Web Hook para tu plugin del Marketplace (más abajo te decimos cómo). Sin él, trazpago te muestra hasta «Enviado».
Ojo con los tokens: los que trazpago necesita son los del plugin de WhatsApp, no los de un plugin del Marketplace de Crisp. Los del Marketplace se ven parecidos, pero Crisp los rechaza para este uso y trazpago te dirá que no reconoce las credenciales.
Pasos en trazpago
- En trazpago abre Configuración → WhatsApp.
- Si ya tenías una cuenta conectada de forma directa con Meta, pulsa Cambiar a Crisp. trazpago desconecta esa cuenta (no toca nada en Meta) y abre el formulario de Crisp. Si no tenías ninguna conexión, pulsa ¿Tu WhatsApp ya está en Crisp? Conéctalo a través de Crisp.
- Llena el formulario: Website ID, Identifier, Key, el Secreto de firma del hook si lo tienes (es opcional) y el Número emisor: el número de WhatsApp Business que usas en Crisp, con lada internacional, por ejemplo +52 55 1234 5678.
- Pulsa Conectar a través de Crisp. trazpago verifica las credenciales con Crisp antes de guardar nada.
Tus credenciales se guardan cifradas y trazpago no vuelve a mostrarlas, ni siquiera a ti. Si algún día necesitas cambiarlas, desconecta y vuelve a conectar.
Último paso: pega estas URLs en Crisp
En cuanto la conexión queda hecha, trazpago te muestra un aviso con dos direcciones y un botón Copiar junto a cada una. Son secretas y solo se muestran ahora: no las mandes por chat ni las guardes en un lugar compartido. Cópialas y pégalas en Crisp antes de pulsar «Ya las pegué en Crisp».
- Callback URL: va en Crisp, en Plugins → WhatsApp → API Settings → Callback URL. Por esta dirección Crisp le confirma a trazpago si cada mensaje salió o no por WhatsApp. Sin ella, tus mensajes se quedarían en «Aceptado por Crisp» aunque sí hayan salido.
- Plugin Hook URL: solo si configuraste el secreto de firma. Va en tu plugin del Marketplace de Crisp: abre tu plugin, entra a la pestaña Settings, baja a la sección Events, pega la dirección en el apartado de producción y pulsa Create Web Hook. En la ventana que se abre elige únicamente estos tres eventos: message:received, message:acknowledge:delivered y message:acknowledge:read:received. Ahí mismo Crisp te muestra el secreto de firma; es el que va en el formulario de trazpago. Crisp advierte que un Web Hook de producción puede necesitar aprobación de su equipo antes de funcionar.
¿Qué pasa si cierras la pantalla sin copiarlas? Nada se rompe, pero no hay forma de volver a verlas: desconecta y vuelve a conectar, y trazpago te dará dos direcciones nuevas. Las anteriores dejan de valer, así que si ya habías pegado alguna en Crisp tendrás que reemplazarla por la nueva.
Un detalle de orden: el secreto de firma aparece en Crisp al crear el Web Hook, y el Web Hook necesita la Plugin Hook URL que trazpago te da al conectar. Si conectaste sin secreto y luego quieres los acuses de entregado y leído, vuelve a conectar con el secreto y pega las direcciones nuevas en Crisp.
Comprueba que todo funciona
- En la sección Plantillas de WhatsApp pulsa Actualizar plantillas. trazpago lee las plantillas de tu cuenta y te muestra la plantilla de prueba tal como le llega a tu cliente: encabezado, texto con valores de ejemplo, pie y botones. Así sabes exactamente qué recibirá antes de que trazpago envíe nada en tu nombre.
- En Envíate un mensaje de prueba escribe tu número con lada internacional, marca la casilla de permiso y pulsa Enviar mensaje de prueba.
- Sigue el estado en la lista Mensajes de prueba. Debe cambiar solo, sin recargar.
Cada estado significa algo distinto, y no son lo mismo:
- Aceptado por Crisp: Crisp recibió la orden de envío. Todavía no significa que el mensaje haya salido por WhatsApp.
- Enviado: Crisp confirmó por la Callback URL que el mensaje salió por WhatsApp. Sin la Callback URL pegada en Crisp, ningún mensaje pasa de «Aceptado».
- Entregado y Leído: llegan por el Plugin Hook. Si no lo configuraste, el máximo que verás es «Enviado», aunque el mensaje sí haya llegado y se haya leído.
- Falló: Crisp no pudo enviarlo. En la lista verás el motivo o el código que Crisp devolvió.
Problemas frecuentes
- «Crisp no reconoce esas credenciales»: casi siempre es un token de un plugin del Marketplace en lugar del par de Plugins → WhatsApp → API Tokens. Genera el par en el plugin de WhatsApp y vuelve a intentarlo. Revisa también que el Website ID sea el del sitio donde está instalado ese plugin.
- «Ya tienes una cuenta conectada»: solo puede haber una conexión de WhatsApp por negocio. Si la que tienes es directa con Meta, usa Cambiar a Crisp en el panel de la cuenta conectada; no hace falta desconectar a mano.
- La conexión queda en «Casi lista»: tu cuenta todavía no tiene la plantilla de prueba de trazpago aprobada por Meta. Las plantillas se crean y aprueban en el WhatsApp Business Manager de Meta, no en trazpago ni en Crisp. Cuando exista y esté aprobada, pulsa Actualizar plantillas y la conexión pasará a «Lista».
- Los mensajes se quedan en «Aceptado por Crisp»: falta la Callback URL en Plugins → WhatsApp → API Settings, o pegaste una dirección de una conexión anterior. Vuelve a conectar para obtener direcciones nuevas y pégalas de nuevo.
- Nunca aparece «Entregado» ni «Leído»: revisa que el Web Hook de tu plugin del Marketplace tenga los tres eventos, que esté aprobado por Crisp si es de producción, y que el secreto de firma que tecleaste en trazpago sea el de ese Web Hook. Crisp muestra en la configuración del plugin si la última llamada al Web Hook falló.
Tu cuenta, tu control
La cuenta de Crisp y el número son tuyos: desde Crisp puedes revocar los tokens o borrar el Web Hook en cualquier momento, y desde trazpago puedes pulsar Desconectar para que se borren las credenciales cifradas y las dos direcciones dejen de valer. trazpago no lee tus conversaciones de Crisp ni guarda los mensajes de tus clientes; solo registra el estado de los avisos que él mismo envió.