Conectar Agenda con Chat Tico

La conexión es bilateral: Chat Tico crea la app y sus credenciales; Agenda guarda esos datos y usa los endpoints cuando una automatización necesita un template o workflow. Conectar no activa mensajes por sí solo.

Contratos verificados: Agenda 6b8b4d4, Chat Tico UI 174de58f39bc3750a296f6cb4c3f077dd93d4ad1 y Chat Tico API 58c880d36616d948d2a3534281ecc4e44a2745d9.

Requisitos

• Rol Dueño o Administrador en Agenda.
• Rol Administrador o Propietario en Chat Tico.
• Organización correcta en ambos productos.
• Un canal de WhatsApp operativo en Chat para enviar mensajes reales.
• Un gestor seguro donde guardar temporalmente el secreto que Chat muestra una sola vez.

1. Crear la app en Chat Tico

1. Abrí Integraciones → Apps conectadas → Conectar app.
2. Elegí Agenda Tico Online.
3. Asigná un nombre reconocible.
4. Elegí el número de WhatsApp cuando corresponda.
5. Creá la conexión.
6. Copiá y guardá de forma segura:
   • org_id;
   • secreto de firma;
   • endpoint del lote;
   • endpoint de plantillas.

El secreto se muestra una sola vez en la interfaz. No lo pegues en tickets, capturas, chats ni documentos públicos.

Consultá también la guía del lado de Chat Tico.

2. Guardar la conexión en Agenda

Ruta: Ajustes → Conexiones → Chat Tico (WhatsApp)

1. Pegá el org_id.
2. Pegá el secreto de firma.
3. Pegá el endpoint del lote.
4. Pegá el endpoint de plantillas.
5. Seleccioná Guardar conexión.

Agenda cifra el secreto en almacenamiento protegido y no lo devuelve al navegador. Al editar una conexión existente, dejar el campo de secreto vacío conserva el actual; no pegues un valor inventado como marcador.

org_id, endpoint del lote y el secreto inicial son necesarios. El endpoint de plantillas permite que Agenda cargue los templates aprobados para seleccionarlos en recetas.

3. Verificar antes de activar mensajes

Guardar la tarjeta solo prueba la configuración básica. Después:

1. Abrí Ajustes → Automatizaciones.
2. Elegí una receta aplicable.
3. Seleccioná un template o workflow disponible.
4. Revisá variables, condiciones, horario y canal.
5. Usá Probar ahora únicamente con una cita autorizada.
6. Revisá Últimos envíos en Agenda y la ejecución correspondiente en Chat. En modo workflow necesitás ambos: el registro de Agenda puede ser solo el acuse de que Chat dejó el trabajo en cola.

Una prueba puede enviar un WhatsApp real. No la ejecutes con datos de clientes sin autorización.

Contrato observable

Agenda usa un endpoint dedicado de lote con organización, receta, modo, nonce, contactos y callbacks. El emisor actual no envía app_type: "agenda"; Chat conserva la compatibilidad de su endpoint dedicado sin exigir ese campo al conector actual.

El secreto protege la solicitud y nunca debe volver a la interfaz. Los dos modos no confirman lo mismo:

• Template: Chat procesa el lote de forma síncrona y la respuesta puede incluir éxito o error por contacto; revisá cada resultado.
• Workflow: Chat responde 202 cuando acepta el lote en cola. Agenda puede mostrarlo como Enviado, pero eso no confirma ejecución ni entrega; un fallo posterior queda en el historial de Chat.

Un estado exitoso tampoco confirma que Meta entregó el mensaje al teléfono. Para cerrar una prueba, contrastá Agenda, la ejecución en Chat y, cuando aplique, el estado del proveedor.

Qué no hace la conexión

• No crea templates de Meta.
• No activa recetas automáticamente.
• No envía recordatorios por el simple hecho de guardar credenciales.
• No convierte un fallo externo en fallo de la cita guardada.
• No demuestra por sí sola callbacks de confirmación o cancelación.

Rotar o deshabilitar

Rotar el secreto en Chat invalida el anterior. Actualizalo en Agenda inmediatamente y probá el circuito controlado antes de reactivar recetas.

Deshabilitar o eliminar la app del lado de Chat detiene su uso. Revisá las automatizaciones de Agenda para que no queden intentando un destino retirado.

Solución de problemas

Agenda dice que faltan datos

Confirmá org_id, secreto y endpoint del lote. El endpoint de plantillas también debe estar configurado para cargar templates.

No aparecen templates

Verificá el endpoint de plantillas, el secreto y que Chat tenga templates aprobados para el canal elegido.

La receta corrió, pero no salió el mensaje

Abrí Últimos envíos. Puede estar omitida por conexión incompleta, template no aplicable, teléfono ausente o regla de estado. Si usa workflow, Enviado puede significar solamente que Chat aceptó la cola; buscá la ejecución y su fallo del lado de Chat. Si usa template, revisá el resultado individual. Ningún estado aislado prueba entrega final del proveedor; comprobá el circuito antes de reintentar.

El callback no cambió la cita

Revisá la regla de webhook, token, identificador y logs de ambos productos. No cambies el estado manualmente y después declares el circuito verificado: separá la corrección operativa de la prueba técnica.

Cambié el secreto y todo dejó de funcionar

El anterior se invalida al rotar. Pegá el nuevo en Agenda, guardá y ejecutá una prueba controlada.

Estado de verificación

El contrato, controles y rutas de ambos repos fueron contrastados. En esta revisión no se envió un WhatsApp ni se ejecutó un callback real; esa verificación E2E sigue pendiente y debe hacerse con un destinatario autorizado.

Siguiente guía

Volvé a la portada de Agenda Tico o revisá cómo editar y cambiar estados.