Tareas en tu CRM: enviar acciones a HubSpot o a un webhook

Qué es#

Una conexión para que cada acción del Centro de acciones pueda convertirse en una tarea de tu equipo: en HubSpot o en cualquier herramienta que reciba un webhook (Zapier, Make, n8n o un servidor propio).

Para qué sirve#

Que la persona que hace el cambio lo tenga en su lista de trabajo, con la evidencia, sin copiar y pegar. Al cerrar o reabrir la acción en VisibAI, la tarea se completa o se reabre.

Cómo conectarlo#

En Ajustes › Integraciones › Tareas en tu CRM, pulsa Configurar y elige el destino:

• HubSpot: crea en HubSpot una app privada y pega su token de acceso. HubSpot pide para las tareas los permisos de contactos (crm.objects.contacts.read y crm.objects.contacts.write); VisibAI solo crea y lee tareas: no lee ni crea contactos. Si quieres, indica el ID del propietario de las tareas.
• Webhook: pega una URL https:// de un dominio público. Al guardar, VisibAI te enseña una sola vez el secreto de firma.

Puedes añadir un equipo y una campaña: son dos etiquetas que viajan con cada tarea. Después, en cada acción, abre Detalles y pulsa Enviar como tarea.

Qué datos envía#

Siempre: el identificador de la acción, su título, el tipo de acción, la prioridad, el estado, la fecha límite y un enlace al panel. Si lo dejas marcado: la evidencia (lo que dijeron las IAs), las preguntas afectadas y tus páginas afectadas.

Cómo se evitan duplicados#

Una acción tiene una sola tarea por destino: si ya la enviaste, el botón enseña la tarea que existe en vez de crear otra. Si borras la tarea en HubSpot, VisibAI lo detecta al comprobar su estado y te deja crear otra. En un webhook, la cabecera Idempotency-Key permite a tu receptor descartar repeticiones.

Cómo se sincroniza el estado#

• De VisibAI a la tarea: al marcar la acción como publicada, descartada o revertida, la tarea pasa a completada; si la reabres, vuelve a sin empezar.
• De HubSpot a VisibAI: con Comprobar el estado en HubSpot ves si la tarea está completada. VisibAI no marca la acción como publicada por eso: una tarea cerrada no demuestra que el cambio esté en tu web. Un webhook no se puede leer: su estado solo se ve en el sistema que lo recibe.

Cómo comprobar la firma del webhook#

Cada envío lleva la cabecera X-VisibAI-Firma: t=<segundos>,v1=<firma>, donde la firma es HMAC-SHA256 con tu secreto sobre t + "." + cuerpo. Rechaza los envíos cuya firma no coincida o cuyo t tenga más de cinco minutos. El tipo de envío va en X-VisibAI-Evento: prueba, tarea_crear o tarea_estado.

Problemas habituales#

• «El destino no acepta la credencial»: el token caducó, se revocó o se copió mal. Pega uno nuevo.
• «La credencial no tiene permiso para crear tareas»: revisa los permisos de la app privada.
• «El destino ha pedido esperar»: HubSpot limita las peticiones. VisibAI no reintenta solo (un reintento a ciegas podría duplicar la tarea): vuelve a pulsar en unos minutos.
• «Ese destino no está permitido»: la URL debe ser pública; no se admiten direcciones internas.

Cómo desconectarlo#

En el mismo apartado, pulsa Desconectar: se borra la credencial guardada. Las tareas que ya existen en tu CRM no se tocan.