Integraciones del sistema

Visión general de las integraciones

Las integraciones conectan Yampi con otras herramientas que tu equipo ya usa: pasarelas de pago, calendarios, inteligencia artificial, CRM inmobiliarios y más. En lugar de saltar entre aplicaciones, traes esas funciones dentro de Yampi para que todo ocurra en un solo lugar. En este artículo conocerás la pantalla de Integraciones, qué significa cada estado y el camino general para activar cualquiera de ellas. Cada integración tendrá además su propio artículo con la configuración paso a paso. Entrar a las integraciones 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. Nota: esta sección es de configuración de la cuenta, por lo que normalmente solo los administradores pueden verla y modificarla. Cómo leer esta pantalla Cada integración aparece como una tarjeta con cuatro elementos: - Nombre y logo del servicio (por ejemplo, Cal.com o OpenAI). - Descripción corta de lo que hace. - Estado, en la esquina superior derecha de la tarjeta: - Activado (verde): la integración ya está conectada y funcionando en tu cuenta. - Deshabilitado (gris): aún no se ha configurado o se desconectó. - Configurar: el enlace que abre la pantalla de conexión de esa integración. Si la lista te parece larga, usa la barra Buscar integraciones en la parte superior para encontrar una por su nombre. Cómo se activa una integración (flujo general) Aunque cada integración pide datos distintos, el camino siempre es el mismo: 1. Ubica la tarjeta de la integración y haz clic en Configurar. 2. Ingresa lo que el servicio externo requiere: puede ser iniciar sesión en tu cuenta de ese servicio, pegar una clave (API key) o completar unos campos. 3. Guarda los cambios. Cuando la conexión es exitosa, el estado de la tarjeta cambia a Activado. Importante: casi todas las integraciones requieren que primero tengas una cuenta en el servicio externo (por ejemplo, una cuenta de Cal.com o de Wasi). Esas credenciales las administra el otro servicio, no Yampi: si olvidaste tu clave de OpenAI o de Wompi, debes recuperarla en la plataforma correspondiente. Qué hace cada integración Para que ubiques rápido la que necesitas, aquí están agrupadas por lo que resuelven. Inteligencia artificial y bots - OpenAI: aprovecha los modelos de lenguaje de OpenAI dentro del chat, con funciones como sugerencias de respuestas, resúmenes de conversaciones, reformulación de mensajes, corrección ortográfica y clasificación de etiquetas. - Notion: conecta tu espacio de trabajo de Notion para que Livia genere respuestas usando el contenido de tus bases de datos, documentos y páginas, y dé un soporte más contextual. - Dialogflow: integra chatbots construidos con Dialogflow en tu bandeja de entrada, para que atiendan las consultas iniciales antes de transferir la conversación a un agente. - Traductor de Google: detecta automáticamente el idioma de los mensajes de los clientes y los traduce al idioma preferido del agente o del administrador. Sector inmobiliario - Wasi: sincroniza automáticamente propiedades y contactos entre Yampi y Wasi CRM, manteniendo ambos sistemas actualizados. - Fianly: corre estudios de scoring (Servidata/Experian) de inquilinos prospecto directamente desde una conversación y emite afianzamientos respaldados por Fianly sin salir de Yampi. Agenda - Cal.com: habilita tu calendario desde las conversaciones para que los agentes reserven reuniones con clientes usando tus tipos de eventos ya configurados. Pagos - Gateway Wompi, Gateway ePayco y Gateway Bold: conectan tu cuenta de cada pasarela de pagos para gestionar cobros a tus clientes desde Yampi. Configura solo la pasarela que tu empresa usa. Para usos avanzados - Webhook: envía actualizaciones en tiempo real sobre la actividad de tu cuenta de Yampi a otros sistemas. Te suscribes a los eventos que prefieras y Yampi hace llamadas HTTP con cada novedad. Pensada para equipos técnicos que quieren conectar Yampi con sistemas propios. - Panel de aplicaciones: permite crear e incrustar aplicaciones que muestran información del cliente (datos, pedidos o historial de pagos) junto a la conversación, dándole más contexto a tus agentes.

Webhook

Un webhook es la forma en que Yampi le avisa automáticamente y en tiempo real a otro sistema cuando algo pasa en tu cuenta: llegó un mensaje, se creó un contacto, cambió el estado de una conversación. Tú eliges qué eventos te interesan y Yampi envía una notificación (una llamada HTTP) a la dirección que definas, con los datos de cada evento. Nota: esta es una integración pensada para usos avanzados. Para configurarla no necesitas programar, pero para aprovechar lo que envía sí se requiere apoyo técnico (un desarrollador o una herramienta de automatización como Zapier, Make o n8n). ¿Para qué sirve? Piensa en el webhook como un mensajero: en lugar de que otro sistema esté preguntándole a Yampi cada rato "¿hay algo nuevo?", Yampi le avisa al instante cada vez que ocurre algo. Con eso puedes, por ejemplo: - Sincronizar contactos con tu propio CRM o base de datos: cada contacto que se crea o se edita en Yampi se replica automáticamente en tu sistema. - Recibir alertas en tiempo real en herramientas internas (por ejemplo, un aviso en Slack o un correo al equipo) cuando entra una conversación nueva. - Alimentar tus propios reportes o dashboards con la actividad de mensajes y conversaciones. - Conectar Yampi con automatizadores como Zapier, Make o n8n, que reciben el evento y disparan flujos sin necesidad de desarrollar un sistema propio. - Construir integraciones a la medida con los sistemas internos de tu inmobiliaria. El webhook solo envía información hacia afuera; no modifica nada dentro de Yampi. Antes de empezar Necesitas una URL pública capaz de recibir las llamadas de Yampi (lo que técnicamente se llama un endpoint). Esa URL te la da: - tu equipo de desarrollo, si van a conectar un sistema propio, - la herramienta de automatización (Zapier, Make y n8n generan una URL de webhook al crear un flujo), o - un servicio de prueba como webhook.site, si solo quieres ver cómo funciona antes de conectarlo en serio. Paso 1: abrir la configuración del Webhook 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Webhook y haz clic en Configurar. Paso 2: añadir un nuevo webhook Se abre la pantalla Webhook. Aquí verás la lista de webhooks de tu cuenta; si aún no has creado ninguno, aparece el mensaje "No hay webhooks configurados para esta cuenta". Cuando tengas varios, puedes ubicarlos con la barra Buscar webhooks. Haz clic en el botón Añadir nuevo webhook (arriba a la derecha). Paso 3: completar el formulario En el modal Añadir nuevo webhook completa: 1. URL de Webhook: la dirección a la que Yampi enviará los eventos (por ejemplo, https://tuempresa.com/api/webhook). Debe ser una URL válida y accesible desde internet. 2. Nombre del Webhook: un nombre descriptivo para reconocerlo en la lista (por ejemplo, "Sincronización CRM" o "Alertas Slack"). 3. Eventos: marca las casillas de los eventos que quieres recibir (abajo te explicamos cada uno). 4. Haz clic en Crear webhook. Desde ese momento, cada vez que ocurra uno de los eventos marcados, Yampi enviará la notificación a tu URL. Los eventos disponibles | Evento | Nombre interno | Se dispara cuando... | | ------------------------------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------- | | Conversación creada | conversation_created | Se abre una conversación nueva en cualquier canal. | | Estado de la conversación cambiado | conversation_status_changed | Una conversación cambia de estado (por ejemplo, se abre, se pospone o se resuelve). | | Conversación actualizada | conversation_updated | Cambia alguna propiedad de la conversación, como el agente asignado, las etiquetas o sus atributos. | | Mensaje creado | message_created | Se envía o se recibe un mensaje en cualquier conversación. | | Mensaje actualizado | message_updated | Un mensaje existente cambia (por ejemplo, su estado de entrega). | | Widget de Live Chat abierto por el usuario | webwidget_triggered | Un visitante abre el widget de chat en tu sitio web. | | Contacto creado | contact_created | Se crea un contacto nuevo en la cuenta. | | Contacto actualizado | contact_updated | Se editan los datos de un contacto existente. | | Conversation Typing On | conversation_typing_on | Alguien comienza a escribir en una conversación. | | Conversation Typing Off | conversation_typing_off | Alguien deja de escribir en una conversación. | Consejo: marca solo los eventos que de verdad vas a usar. Eventos como message_created o los de typing generan un volumen alto de llamadas; si tu sistema solo necesita los contactos nuevos, basta con contact_created. Cómo funciona por dentro (para tu equipo técnico) - Por cada evento, Yampi hace una petición HTTP POST a la URL configurada, con un cuerpo en formato JSON que describe el evento y sus datos (la conversación, el mensaje o el contacto involucrado). - El sistema que recibe debe responder con un código de éxito (200). - Un mismo webhook puede suscribirse a varios eventos, y puedes crear varios webhooks apuntando a URLs distintas (por ejemplo, uno para el CRM y otro para las alertas internas). Probar el webhook sin programar ¿Quieres ver los eventos en acción antes de conectar un sistema real? 1. Entra a webhook.site y copia la URL única que te genera. 2. En Yampi, crea un webhook con esa URL y marca un evento fácil de provocar, por ejemplo Contacto creado. 3. Crea un contacto de prueba en Yampi. 4. Vuelve a webhook.site: verás llegar la llamada con todos los datos del contacto en formato JSON. Cuando termines la prueba, elimina ese webhook para no seguir enviando datos de tu cuenta a un servicio externo. Administrar tus webhooks Los webhooks creados aparecen en la lista de la pantalla Webhook, identificados por su nombre y su URL. Desde ahí puedes revisar cuáles están activos y gestionar cada uno. Preguntas frecuentes ¿Necesito saber programar para usar webhooks? Para crearlos en Yampi no, el formulario es simple. Para recibir y aprovechar los datos sí se necesita apoyo técnico o una herramienta de automatización (Zapier, Make, n8n). ¿El webhook puede modificar información en Yampi? No. Los webhooks solo envían información hacia afuera. Para que otro sistema escriba datos en Yampi se usan otros mecanismos (como la API). ¿Puedo tener varios webhooks a la vez? Sí. Puedes crear uno por cada sistema de destino, cada uno con su propia URL y su propia selección de eventos. ¿Qué pasa si mi URL deja de funcionar? Yampi intentará entregar los eventos, pero si tu sistema no responde, esas notificaciones se pierden. Verifica que la URL esté siempre disponible.

Panel de aplicaciones

El Panel de aplicaciones te permite incrustar una página o aplicación de tu empresa dentro de Yampi, para que tus agentes vean información adicional del cliente sin salir de la conversación: sus datos en tu sistema interno, sus pedidos, su historial de pagos o cualquier otra vista que tu equipo construya. Es el camino inverso al webhook: en lugar de enviar datos de Yampi hacia afuera, trae información de tus sistemas hacia adentro. Nota: esta es una integración pensada para usos avanzados. Configurarla en Yampi toma un minuto, pero la aplicación que se incrusta debe existir primero: la construye tu equipo de desarrollo y debe estar publicada en una URL accesible. ¿Para qué sirve? Cuando un agente atiende una conversación, muchas veces necesita datos que no viven en Yampi. Con una aplicación de panel puede consultarlos ahí mismo, por ejemplo: - La ficha del cliente en tu sistema interno: estado de su contrato de arriendo, propiedades asociadas, saldo pendiente. - Historial de pagos o facturación, para responder dudas de cobros sin cambiar de pestaña. - Pedidos o solicitudes en curso, como visitas agendadas o trámites en proceso. - Cualquier herramienta web propia que el equipo use durante la atención. El resultado: menos cambio de ventanas, respuestas más rápidas y agentes con el contexto completo del cliente. Antes de empezar Necesitas la URL pública de la aplicación que quieres incrustar (lo que técnicamente se llama un endpoint). Esa URL te la da tu equipo de desarrollo: es la dirección donde está publicada la página o aplicación web que se mostrará dentro de Yampi. Si solo quieres probar cómo funciona, puedes usar cualquier página pública como ensayo. Paso 1: abrir el Panel de aplicaciones 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Panel de aplicaciones y haz clic en Configurar. Paso 2: añadir una nueva aplicación Se abre la pantalla Panel de aplicaciones. Aquí verás la lista de aplicaciones de tu cuenta; si aún no has creado ninguna, aparece el mensaje "Todavía no hay aplicaciones configuradas en esta cuenta". Cuando tengas varias, puedes ubicarlas con la barra Buscar apps de panel. Haz clic en el botón Añadir una nueva aplicación (arriba a la derecha). Paso 3: completar el formulario En el modal Añadir una nueva aplicación completa: 1. Nombre: un nombre descriptivo para reconocer la aplicación (por ejemplo, "Historial de pagos" o "Ficha del cliente"). Este es el nombre que verán tus agentes. 2. Endpoint: la URL donde está alojada tu aplicación (por ejemplo, https://tuempresa.com/panel-clientes). Debe ser una URL válida y accesible desde internet. 3. Haz clic en Enviar. La aplicación queda registrada y disponible para tus agentes dentro de las conversaciones. ¿Dónde la ven los agentes? Una vez creada, la aplicación aparece como una pestaña adicional dentro de la vista de conversación, identificada con el nombre que le diste. Al abrirla, Yampi carga tu aplicación ahí mismo, junto al chat, para consultarla sin salir de la conversación. Cómo funciona por dentro (para tu equipo técnico) - Yampi incrusta la URL configurada dentro del panel (como un iframe), por lo que la aplicación debe permitir ser embebida y servirse por HTTPS. - La aplicación puede recibir el contexto de la conversación en curso (datos del contacto y de la conversación) para mostrar información del cliente correcto automáticamente. - Puedes crear varias aplicaciones distintas, cada una con su propio nombre y URL (por ejemplo, una para pagos y otra para contratos). Preguntas frecuentes ¿Necesito saber programar para usar el Panel de aplicaciones? Para registrarla en Yampi no: el formulario son dos campos. Pero la aplicación que se incrusta debe construirla y publicarla tu equipo de desarrollo. ¿La aplicación puede modificar datos en Yampi? No. El panel solo muestra tu aplicación dentro de Yampi para dar contexto al agente. Para escribir datos en Yampi se usan otros mecanismos (como la API). ¿Todos los agentes ven la aplicación? Sí, la aplicación queda disponible en las conversaciones de la cuenta para el equipo. ¿Puedo incrustar cualquier página web? Solo si esa página permite ser embebida. Muchos sitios de terceros lo bloquean por seguridad; lo habitual es incrustar aplicaciones propias, pensadas para este uso.

OpenAI

La integración con OpenAI convierte a Yampi en un asistente de escritura para tu equipo: mientras tus agentes atienden conversaciones, la inteligencia artificial les sugiere respuestas, resume conversaciones largas, reformula mensajes, corrige la ortografía y hasta propone etiquetas para clasificar cada caso. Todo ocurre dentro de la conversación, sin copiar y pegar en herramientas externas. Nota: esta integración asiste a tus agentes humanos mientras escriben. No responde sola a los clientes; para eso Yampi cuenta con Livia, el agente de inteligencia artificial de la plataforma. ¿Qué puedes hacer con OpenAI en Yampi? - Sugerencias de respuesta: la IA lee la conversación y propone una respuesta lista para revisar, editar y enviar. Ideal para acelerar la primera reacción. - Resúmenes de conversación: genera en segundos un resumen de todo el hilo. Útil cuando recibes una conversación transferida o retomas un caso antiguo sin releerlo completo. - Reformulación de mensajes: reescribe el borrador de tu agente con otro tono (por ejemplo, más profesional o más cercano) manteniendo la idea original. - Corrección ortográfica y gramatical: pule el mensaje antes de enviarlo, cuidando la imagen de tu inmobiliaria. - Clasificación de etiquetas: si lo activas, la IA sugiere etiquetas para la conversación según su contenido (por ejemplo, "arriendo", "pagos", "visita"), ayudando a mantener el orden sin esfuerzo manual. Antes de empezar Para activar esta integración necesitas una API key de OpenAI: una clave secreta (un código largo que empieza por sk-) que autoriza a Yampi a usar los modelos de OpenAI en nombre de tu cuenta. Cada vez que un agente pide una sugerencia, un resumen o una corrección, Yampi consulta a OpenAI con esa clave, y OpenAI descuenta el costo del saldo de tu cuenta. Antes de generar la clave, conviene aclarar la duda que más confunde a los equipos nuevos. No es lo mismo pagar ChatGPT que pagar la API OpenAI vende dos productos distintos, con cobros separados: - ChatGPT (los planes Free, Go, Plus o Pro de chatgpt.com) es una suscripción personal: pagas una tarifa fija al mes para que una persona converse con la IA en la app de ChatGPT. - La API (en platform.openai.com) es el servicio para que otras aplicaciones, como Yampi, usen esos mismos modelos por dentro. No tiene mensualidad: se descuenta de un saldo según el uso real. Tener ChatGPT Plus no incluye crédito ni acceso a la API, y cargar saldo en la API no te da ChatGPT Plus. Son facturas independientes, aunque entres a las dos con el mismo correo. Por eso, aunque tú o tu equipo ya paguen ChatGPT, para Yampi necesitas configurar la API con su propio saldo o método de pago. | | Plan de ChatGPT (Free, Go, Plus, Pro) | API key de OpenAI (lo que usa Yampi) | | --------------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | | Qué es | Una suscripción para conversar con la IA en la app o la web de ChatGPT. | Una clave que permite que otras aplicaciones usen los modelos de OpenAI. | | Dónde se contrata | chatgpt.com o la app móvil. | platform.openai.com, sección Billing. | | Cómo se cobra | Tarifa fija mensual (por ejemplo, Plus cuesta unos US$ 20 al mes), la uses mucho o poco. | Por uso: cada consulta descuenta centavos (o fracciones de centavo) del saldo. Si nadie la usa, no se cobra nada. | | Quién lo aprovecha | Solo la persona dueña de esa cuenta, en sus propios chats. | Todos los agentes de tu cuenta de Yampi, dentro de las conversaciones. | | ¿Sirve para esta integración? | No: Yampi no puede conectarse a una suscripción de ChatGPT. | Sí: es exactamente lo que pide el formulario de conexión. | En resumen: para usar la IA en Yampi no necesitas ningún plan de ChatGPT. Necesitas una cuenta en platform.openai.com con saldo y su API key. Si además usas ChatGPT para otras tareas, ese plan se sigue pagando aparte. ¿Cuánto cuesta usar la API? OpenAI cobra por la cantidad de texto que sus modelos leen y generan, medida en tokens (fragmentos de palabra). Cada sugerencia de respuesta, resumen o corrección consume unos pocos, así que el costo por acción es de centavos o menos según el modelo; para un equipo de soporte el gasto mensual suele ser bajo, pero depende directamente del volumen de conversaciones. Ese costo lo cobra OpenAI en tu cuenta; Yampi no cobra nada por esta integración. Dos consejos para empezar con el gasto bajo control: - Recarga un monto pequeño (por ejemplo, US$ 5 o 10) en la sección Billing y observa cuánto te dura con tu volumen real, antes de activar recargas automáticas. - Define un límite de gasto mensual en esa misma sección para evitar sorpresas. Los precios por token los fija OpenAI y cambian con el tiempo; consulta su página oficial de precios para ver la tarifa vigente. Generar tu API key 1. Crea o ingresa a tu cuenta en platform.openai.com. Si ya usas ChatGPT puedes entrar con el mismo correo, pero recuerda que la facturación de la API se configura aparte. 2. En la sección Billing, verifica que la cuenta tenga créditos o un método de pago activo: sin saldo, la clave se crea igual pero las funciones de IA no responderán en Yampi. 3. En la sección API keys, genera una clave nueva y cópiala en un lugar seguro: OpenAI solo la muestra completa una vez. Si la pierdes, no hay problema: revoca esa clave y genera otra. Trata la API key como una contraseña: cualquiera que la tenga puede gastar tu saldo. No la compartas por chat ni la publiques en capturas de pantalla. Paso 1: abrir la integración 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta OpenAI y haz clic en Configurar. Paso 2: conectar tu cuenta En la pantalla OpenAI, haz clic en el botón Conectar. Paso 3: ingresar la API key En el modal que se abre: 1. API Key: pega la clave que generaste en OpenAI. 2. Show label suggestions (mostrar sugerencias de etiquetas): márcala si quieres que la IA proponga etiquetas para tus conversaciones automáticamente. Puedes dejarla desmarcada y activarla después. 3. Haz clic en Crear. La integración queda activada y las funciones de IA aparecen de inmediato para todos los agentes de la cuenta. Cómo usar las funciones de IA en una conversación Una vez conectada la integración, las funciones viven dentro de la vista de conversación: - Sugerir respuesta: al abrir una conversación que espera respuesta, encontrarás la opción de sugerencia con IA en el editor de mensajes. Al usarla, el cuadro de texto se llena con la propuesta para que la revises, edites y envíes. - Mejorar tu borrador: escribe tu mensaje y usa la opción de IA del editor para reformularlo, corregir ortografía o cambiar el tono antes de enviarlo. - Resumir la conversación: desde la pestaña de nota privada, la opción de resumen genera una síntesis del hilo que queda como nota interna, visible solo para tu equipo. - Etiquetas sugeridas: si activaste la casilla en la configuración, verás sugerencias de etiquetas en la conversación, listas para aceptar con un clic. Buenas prácticas - Revisa antes de enviar. Las sugerencias de la IA son un punto de partida, no una respuesta garantizada: pueden contener errores o datos imprecisos. El agente siempre tiene la última palabra. - Cuida la privacidad. Para generar sugerencias, el contenido de la conversación se envía a OpenAI. Tenlo en cuenta según las políticas de datos de tu empresa. - Monitorea el consumo. Puedes ver el uso y el gasto de tu API key en el panel de OpenAI. Preguntas frecuentes ¿Esta integración tiene costo? Yampi no cobra por activarla, pero OpenAI cobra por el uso de su API según su tarifa por volumen. Ese costo se factura directamente en tu cuenta de OpenAI. ¿Es lo mismo que Livia? No. Livia es el agente de IA de Yampi que puede atender conversaciones por sí sola. La integración con OpenAI es una herramienta de apoyo para tus agentes humanos: sugiere, resume y mejora textos, pero nunca envía nada sin que el agente lo decida. ¿Las respuestas de la IA son siempre correctas? No necesariamente. La IA no conoce tus propiedades ni tus políticas internas; redacta a partir de la conversación. Por eso toda sugerencia debe revisarse antes de enviarse al cliente. Las funciones de IA dejaron de aparecer, ¿qué pasó? Lo más común es que la API key se haya quedado sin créditos o haya sido revocada. Genera una clave nueva en OpenAI y vuelve a configurar la integración. ¿Quiénes pueden usar las funciones una vez conectadas? Todos los agentes de la cuenta las ven dentro de las conversaciones. La configuración (conectar o desconectar la clave) queda reservada a los administradores.

Cal.com

La integración con Cal.com conecta tu calendario a Yampi para que tus agentes agenden reuniones con los clientes sin salir de la conversación: una visita a una propiedad, una llamada o un avalúo quedan reservados en segundos, usando los tipos de eventos que ya tengas configurados en tu cuenta de Cal.com. Se acabó el ir y venir de "¿te sirve el martes? ¿y el jueves?": el agente ofrece los horarios realmente disponibles y confirma en el momento. Nota: Cal.com no es la única opción. Yampi también permite conectar Google Calendar y, próximamente, Outlook Calendar; al final del artículo te contamos cómo. ¿Qué puedes hacer con Cal.com en Yampi? - Reservar reuniones desde el chat: mientras conversas con un cliente, agendas la cita directamente, sin cambiar de pestaña ni copiar enlaces a mano. - Usar tus tipos de eventos: las reuniones se crean según los eventos que definiste en Cal.com (por ejemplo, "Visita a propiedad — 30 min" o "Llamada de asesoría — 15 min"), con su duración y disponibilidad ya configuradas. - Evitar cruces de agenda: solo se ofrecen horarios libres según tu calendario, así que no hay riesgo de agendar dos visitas a la misma hora. Antes de empezar Necesitas una cuenta de Cal.com (tiene plan gratuito) y su clave API (una clave secreta que autoriza a Yampi a usar tu calendario en tu nombre): 1. Crea o ingresa a tu cuenta en cal.com. 2. Configura tus tipos de eventos (event types): nombre, duración y disponibilidad. Estos son los que tus agentes podrán reservar desde Yampi. 3. Genera tu clave API en **Configuración de **Cal.com → Seguridad → Claves API y cópiala en un lugar seguro. Trata la clave API como una contraseña: no la compartas por chat ni la publiques en capturas de pantalla. Consejo: crea tipos de eventos pensados para tu operación inmobiliaria (visitas, avalúos, firmas de contrato) antes de conectar; así el equipo los encuentra listos desde el primer día. Paso 1: abrir la integración 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Cal.com y haz clic en Configurar. Paso 2: conectar tu cuenta En la pantalla Cal.com, haz clic en el botón Conectar. Paso 3: verificar que quedó activada La tarjeta de Cal.com en Integraciones muestra la etiqueta Activado, y al entrar a Configurar verás la integración conectada con el botón Eliminar disponible. Configura tu calendario en Yampi Además de conectar la integración, Yampi tiene una pantalla propia para gestionar tu calendario: 1. Ve a Ajustes (engranaje) y despliega la sección Aplicaciones. 2. Haz clic en Calendario. La pantalla Configuración de Calendario tiene dos pestañas: Disponibilidad e Integraciones. Pestaña Disponibilidad Aquí defines cuándo y cómo se pueden agendar reuniones contigo: - Zona horaria: la referencia para todos los horarios (por ejemplo, Bogotá GMT-05:00). - Aviso mínimo (minutos): con cuánta anticipación mínima se puede reservar. Útil para evitar citas de un momento a otro. - Frecuencia de slots (minutos): cada cuánto se ofrecen horarios disponibles. Con 30, se ofrecen espacios a las 9:00, 9:30, 10:00... - Duración del evento (minutos): cuánto dura cada reunión. - Buffer entre eventos (minutos): descanso obligatorio entre una cita y la siguiente, por ejemplo para desplazarte entre propiedades. - Establecer sus horas semanales: marca los días que atiendes y la franja horaria de cada uno. Los días sin marcar aparecen como No disponible y nadie podrá agendar en ellos. Pestaña Integraciones: Cal.com, Google Calendar y Outlook En esta pestaña encuentras los proveedores de calendario que puedes conectar: Para completar la **Integración **Cal.com debes ingresar la clave API En el formulario **Integración **Cal.com: 1. **Clave API de **Cal.com: pega la clave que generaste en **Configuración de **Cal.com → Seguridad → Claves API (el mismo formulario te recuerda la ruta). **Nota : La conexión con Google (y con Outlook cuando esté disponible) es distinta a la de **Cal.com: no usa clave API. Al hacer clic en Configurar, el proveedor te lleva a iniciar sesión con tu cuenta y autorizar el acceso; al aceptar, la sincronización queda activa. Outlook Calendar: aparece como Próximamente; aún no está disponible. Cómo desconectar la integración 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Cal.com. 2. Haz clic en el botón Eliminar. La conexión con tu calendario se elimina y la opción de agendar desaparece de las conversaciones. Las reuniones ya creadas no se borran: siguen existiendo en tu cuenta de Cal.com. Preguntas frecuentes ¿Esta integración tiene costo? Yampi no cobra por activarla. Cal.com ofrece un plan gratuito con las funciones esenciales; los planes de pago dependen de Cal.com, no de Yampi. ¿Qué es un "tipo de evento"? Es una plantilla de reunión que defines en Cal.com: nombre, duración, disponibilidad y modalidad (presencial o virtual). Desde Yampi, tus agentes reservan usando esas plantillas. **¿Puedo usar Google Calendar u Outlook en lugar de **Cal.com? Sí. En Ajustes → Aplicaciones → Calendario → Integraciones puedes conectar Google Calendar iniciando sesión con tu cuenta de Google y autorizando el acceso. Outlook Calendar aparece como próximamente. ¿Los horarios que se ofrecen están siempre actualizados? Sí. La disponibilidad se calcula en tiempo real según tu calendario y las reglas de la pestaña Disponibilidad, así que solo se ofrecen espacios realmente libres. No aparece la opción de calendario en las conversaciones, ¿qué reviso? Verifica que la tarjeta de Cal.com figure como Activado en Integraciones, que tu cuenta de Cal.com tenga al menos un tipo de evento creado y activo, y que en Ajustes → Aplicaciones → Calendario tengas días marcados como disponibles. ¿Quiénes pueden usar el calendario una vez conectado? Todos los agentes de la cuenta pueden reservar desde las conversaciones. Conectar o eliminar la integración queda reservado a los administradores.

Wasi

La integración con Wasi, conecta Yampi con Wasi CRM, uno de los CRM inmobiliarios más usados en Latinoamérica. Una vez conectada, tus propiedades y tus contactos se sincronizan automáticamente entre las dos plataformas: lo que tienes en Wasi aparece en Yampi y ambos sistemas se mantienen actualizados, sin que tengas que digitar la misma información dos veces. Es la integración ideal si tu inmobiliaria ya lleva su inventario en Wasi y quieres atender a tus clientes desde Yampi sin abandonar tu CRM de siempre. ¿Qué hace esta integración? - Sincroniza tus propiedades: el inventario de inmuebles que gestionas en Wasi queda disponible en Yampi, para que tus agentes lo consulten y compartan durante las conversaciones. - Sincroniza tus contactos: los clientes y prospectos se mantienen alineados entre ambas plataformas, evitando registros a medias o desactualizados. - Mantiene ambos sistemas al día: la sincronización es automática; te olvidas de exportar e importar archivos o de copiar datos a mano entre sistemas. ¿Por qué importa? El doble registro es una de las principales fuentes de errores en una inmobiliaria: precios desactualizados en un sistema, teléfonos viejos en el otro. Con la integración activa, alimentas la información una sola vez. Antes de empezar Para conectar Wasi necesitas tres cosas: - Una cuenta de Wasi con Plan Pro. El acceso a la API (la "llave" que permite que otras plataformas se conecten con Wasi) solo está disponible en ese plan. Es un requisito de Wasi, no de Yampi. - Ser administrador, tanto en Wasi (para generar las credenciales) como en Yampi (para activar integraciones). - Las dos credenciales de la API de Wasi, que obtienes en el siguiente paso: - ID de Empresa (id_company): un número que identifica a tu inmobiliaria dentro de Wasi, por ejemplo 12345. - Token de API (wasi_token): una clave secreta con formato de cuatro bloques separados por guiones bajos, similar a XXXX_XXXX_XXXX_XXXX. Trata el Token de API como una contraseña: no lo compartas por chat, no lo publiques en capturas de pantalla y guárdalo en un lugar seguro. Paso 1: genera tus credenciales en Wasi Este paso se hace dentro de Wasi, no en Yampi: 1. Inicia sesión en tu cuenta de wasi.co con un usuario administrador. 2. Abre el menú Configuración y entra a Ajustes generales. 3. Baja hasta el final de la página, a la sección API de Wasi. 4. Haz clic en el botón Generar token. 5. Wasi te mostrará los dos valores que necesitas: id_company (el ID de Empresa) y wasi_token (el Token de API). Cópialos ambos. Nota: si en esa sección ya aparece un token generado, no generes uno nuevo: copia el que ya existe. El botón Generar un nuevo token invalida el anterior de inmediato, y cualquier otra conexión que lo estuviera usando (tu página web, portales inmobiliarios, plugins) dejaría de funcionar hasta que la actualices con el token nuevo. Nota: en esa misma sección Wasi ofrece el botón Desactivar token. Si alguien lo usa, se corta el acceso de todas las plataformas conectadas por API, incluida Yampi. Paso 2: abre la integración en Yampi 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Wasi y haz clic en Configurar. Paso 3: haz clic en Conectar En la pantalla Wasi, haz clic en el botón Conectar para abrir el formulario de credenciales. Paso 4: ingresa las credenciales y verifica la conexión En el formulario Conectar con Wasi CRM completa los dos campos con los valores que copiaste en el Paso 1 (el propio formulario te recuerda dónde encontrarlos: Wasi > Configuración > API): 1. ID de Empresa: escribe el número de id_company (por ejemplo, 12345). Es solo el número, sin letras ni espacios. 2. Token de API: pega el wasi_token completo, tal como te lo dio Wasi, respetando los guiones bajos y sin espacios al inicio o al final (cuidado con los espacios que a veces se cuelan al copiar y pegar). 3. Haz clic en Verificar conexión. El botón se llama así por una razón: antes de guardar nada, Yampi comprueba las credenciales directamente contra Wasi. Así evitas dejar configurada una conexión que en realidad no funciona. Si los datos son correctos, la integración queda conectada y la tarjeta de Wasi en Integraciones pasa a mostrar la etiqueta Activado. Si la verificación falla Cuando las credenciales no pasan la verificación, revisa en este orden: 1. El ID de Empresa: debe ser exactamente el número de id_company que muestra Wasi. Un dígito de más o de menos es la causa más común. 2. El Token de API: verifica que lo pegaste completo, con sus cuatro bloques y guiones bajos, y sin espacios extra al inicio o al final. 3. Tu plan de Wasi: si las credenciales son correctas pero la conexión falla, confirma que tu cuenta de Wasi tenga el Plan Pro activo. Sin él, Wasi rechaza cualquier conexión por API (es regla de Wasi, no de Yampi). 4. El estado del token en Wasi: si alguien de tu equipo generó un token nuevo o lo desactivó después de que copiaste el tuyo, el que tienes ya no sirve. Entra de nuevo a Configuración → Ajustes generales → API de Wasi, copia el token vigente (o genera uno si está desactivado) y vuelve a intentarlo. Si nada de esto lo resuelve, escribe a soporte indicando el mensaje de error que te aparece. Qué pasa después de conectar Con la integración activa, la sincronización de propiedades y contactos entre Yampi y Wasi se hace de forma automática: no tienes que ejecutar nada manualmente. Nota: los cambios pueden tardar unos minutos en reflejarse de un sistema al otro. La API de Wasi usa caché (una memoria temporal) en algunas consultas para responder más rápido, así que la actualización no siempre es instantánea; es comportamiento de Wasi, no de Yampi. Cómo desconectar la integración 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Wasi. 2. Haz clic en el botón Eliminar. La conexión entre las dos plataformas se corta y la sincronización automática se detiene. Tu información en Wasi no se toca: tu cuenta y tus datos siguen intactos en tu CRM. Consejo: si desconectas porque el token cambió, no hace falta nada más que volver a conectar con las credenciales nuevas siguiendo los pasos de este artículo. Preguntas frecuentes ¿Necesito un plan de pago en Wasi? Sí. La API de Wasi (lo que permite esta conexión) solo está disponible en el Plan Pro de Wasi. Es un requisito de Wasi, no un cobro de Yampi: Yampi no cobra por activar la integración. ¿Dónde vuelvo a encontrar mis credenciales? En Wasi: Configuración → Ajustes generales, sección API de Wasi, al final de la página. Ahí siempre verás el id_company y el wasi_token vigentes. ¿Qué se sincroniza exactamente? Las propiedades y los contactos de tu cuenta. La sincronización mantiene ambos sistemas actualizados automáticamente. ¿Qué pasa si genero un nuevo token en Wasi? El token anterior deja de funcionar en ese mismo momento y la conexión con Yampi (y con cualquier otra plataforma que lo usara) se cae. Tendrás que volver a conectar la integración con el token nuevo. ¿Puedo seguir trabajando en Wasi normalmente? Sí. La integración no reemplaza a Wasi ni bloquea nada: sigues usando tu CRM como siempre, y Yampi se mantiene sincronizado con él. ¿Necesito saber programar? No. Todo se hace con clics: generas el token en Wasi, copias dos valores y los pegas en Yampi. La verificación falla y ya revisé las credenciales, ¿qué más puede ser? Casi siempre es el plan (necesitas Plan Pro en Wasi) o un token que fue regenerado o desactivado por otra persona del equipo. Revisa la sección "Si la verificación falla" de este artículo.

Fianly

La integración con Fianly conecta Yampi con Fianly, una afianzadora digital colombiana. Una vez conectada, puedes correr estudios de scoring de tus inquilinos prospecto (con centrales de información como Servidata y Experian) directamente desde una conversación, y emitir afianzamientos respaldados por Fianly sin salir de Yampi. Es la integración ideal si tu inmobiliaria afianza sus contratos con Fianly: el estudio del candidato se hace en el mismo chat donde lo estás atendiendo. ¿Qué es Fianly? Fianly es una empresa colombiana de afianzamiento de contratos de arrendamiento, 100% digital. Un afianzamiento es una garantía de pago: si el inquilino deja de pagar, Fianly responde por el arriendo (y según la cobertura, también por la administración y los servicios públicos) y se encarga de la gestión de cobranza. Es la alternativa moderna al codeudor con finca raíz de toda la vida. Dos cosas la hacen especial para una inmobiliaria: - Estudios de arrendatario casi instantáneos: mientras una afianzadora tradicional tarda hasta 24 horas, Fianly analiza al candidato en segundos, con solo su nombre y número de documento, consultando centrales de información crediticia como Servidata y Experian. - Todo el proceso es en línea: estudio, afianzamiento, contrato con firma electrónica e inventario digital, sin papeleo ni codeudores. Desde 2020, Fianly ha recuperado más de $800 millones de pesos en cánones para más de 500 clientes en Colombia. ¿Qué hace esta integración? - Corre estudios de scoring desde el chat: cuando estás conversando con un inquilino prospecto en Yampi, puedes lanzar su estudio de Fianly sin cambiar de plataforma ni volver a digitar sus datos. - Emite afianzamientos sin salir de Yampi: si el estudio es aprobado, puedes emitir el afianzamiento respaldado por Fianly desde la misma pantalla. ¿Por qué importa? En arrendamientos, la velocidad cierra negocios. Un prospecto interesado que debe esperar un día por su estudio puede enfriarse o arrendar en otro lado. Con esta integración, el estudio se resuelve en la misma conversación, mientras el interés está vivo. Antes de empezar Para conectar Fianly necesitas tres cosas: - Una cuenta activa de Fianly. Si tu inmobiliaria aún no trabaja con Fianly, crea la cuenta en web.fianly.com/auth/registro, eligiendo el tipo de usuario con el que vas a operar (por ejemplo, Inmobiliaria o Propietario). Si tienes dudas del proceso comercial, Fianly atiende en [email protected] y por WhatsApp al +57 313 528 9236. - Ser administrador en Yampi, para poder activar integraciones. - Tus credenciales de acceso a Fianly: el usuario y la contraseña con los que inicias sesión en web.fianly.com. Nota: a diferencia de otras integraciones, aquí no hay ningún token ni clave de API que copiar. Se usan directamente tus credenciales de inicio de sesión: Yampi las emplea una sola vez para autenticarse contra la API de Fianly y obtener un token de acceso. Tu contraseña nunca se almacena en Yampi. Paso 1: ten a la mano tus credenciales de Fianly Este paso se hace fuera de Yampi: 1. Ubica el usuario con el que entras a Fianly. Puede ser tu correo, tu número de documento o tu celular: cualquiera de los tres que uses normalmente para iniciar sesión sirve. 2. Ten lista tu contraseña de Fianly. 3. ¿No la recuerdas? Recupérala primero desde la pantalla de inicio de sesión de Fianly y confirma que puedes entrar. Conectar con una contraseña incorrecta es la causa número uno de fallos en la verificación. 4. Identifica el rol con el que usas Fianly (por ejemplo, Propietario o Inmobiliaria): te lo preguntará el formulario. Paso 2: abre la integración en Yampi 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Fianly y haz clic en Configurar. Paso 3: haz clic en Conectar En la pantalla Fianly, haz clic en el botón Conectar para abrir el formulario de credenciales. Paso 4: ingresa tus credenciales y verifica la conexión En el formulario Conectar con Fianly completa los tres campos: 1. Correo, documento o celular: escribe el usuario con el que inicias sesión en Fianly, exactamente como lo usas allá. 2. Contraseña: tu contraseña de Fianly (mínimo 7 caracteres). Recuerda: se usa solo para obtener el token de acceso y nunca se almacena. 3. Tipo de cuenta: despliega la lista y selecciona el rol con el que usas Fianly (por ejemplo, Propietario). Si eliges un rol distinto al de tu cuenta real, la conexión puede fallar o comportarse de forma inesperada. 4. Haz clic en Verificar conexión. Antes de guardar nada, Yampi comprueba las credenciales directamente contra Fianly. Si son correctas, la integración queda conectada y la tarjeta de Fianly en Integraciones pasa a mostrar la etiqueta Activado. Si la verificación falla Revisa en este orden: 1. Usuario y contraseña: abre web.fianly.com en otra pestaña e intenta iniciar sesión con esos mismos datos. Si allá tampoco entras, el problema son las credenciales: recupera la contraseña en Fianly y vuelve a intentarlo. 2. Espacios de más: al copiar y pegar el correo o el documento a veces se cuela un espacio al inicio o al final. Bórralo. 3. El tipo de cuenta: confirma que el rol seleccionado corresponde al de tu cuenta de Fianly. 4. El estado de tu cuenta en Fianly: si tu cuenta es muy nueva o tiene algún bloqueo, contacta a Fianly ([email protected] o WhatsApp +57 313 528 9236). Si las credenciales funcionan en Fianly pero la verificación sigue fallando en Yampi, escribe a soporte indicando el mensaje de error que te aparece. Qué pasa después de conectar Con la integración activa, las acciones de Fianly quedan disponibles dentro de tus conversaciones en Yampi: - Estudio de scoring del prospecto: con los datos básicos del candidato (nombre y número de documento), lanzas el estudio y Fianly consulta las centrales de información (Servidata/Experian) para devolverte el resultado en segundos, sin que salgas del chat. - Emisión del afianzamiento: con el estudio aprobado, puedes emitir el afianzamiento respaldado por Fianly para ese contrato de arrendamiento. Importante: para consultar a una persona en centrales de información crediticia, la ley colombiana (habeas data) exige su autorización previa y expresa. Asegúrate de contar con esa autorización del prospecto antes de correr su estudio. Cómo desconectar la integración 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Fianly. 2. Haz clic en el botón Eliminar. La conexión se corta y las acciones de Fianly dejan de estar disponibles en las conversaciones. Tu cuenta de Fianly no se toca: tus afianzamientos y estudios siguen intactos en la plataforma de Fianly. Consejo: si cambiaste tu contraseña en Fianly y la integración deja de funcionar, simplemente vuelve a conectarla con la contraseña nueva siguiendo los pasos de este artículo. Preguntas frecuentes ¿Qué es un afianzamiento? Una garantía de pago para el contrato de arrendamiento: si el inquilino incumple, la afianzadora (Fianly) responde por el canon y gestiona la cobranza. Reemplaza la figura tradicional del codeudor. ¿Qué son Servidata y Experian? Centrales de información crediticia. Guardan el historial de pagos y comportamiento financiero de las personas; Fianly las consulta para calcular el scoring (puntaje de riesgo) del inquilino prospecto. ¿Yampi guarda mi contraseña de Fianly? No. La contraseña se usa una sola vez para autenticarse contra la API de Fianly y obtener un token de acceso. Es ese token, no tu contraseña, lo que mantiene viva la conexión. ¿Necesito una cuenta de Fianly? Sí. La integración usa tus credenciales de Fianly, así que primero debes tener cuenta activa allá. El registro es en línea en web.fianly.com/auth/registro. ¿Cuánto cuesta? Yampi no cobra por activar la integración. Los estudios y afianzamientos se rigen por las tarifas y condiciones comerciales de Fianly; consúltalas directamente con ellos. ¿Qué tipo de cuenta elijo en el formulario? El mismo rol con el que operas en Fianly (por ejemplo, Propietario o Inmobiliaria). Si no lo tienes claro, revisa con qué tipo de usuario te registraste en Fianly. ¿El prospecto debe autorizar el estudio? Sí. Consultar centrales de riesgo sin autorización previa y expresa viola la ley de habeas data. Pide siempre la autorización antes de correr el estudio. ¿Necesito saber programar? No. Todo se hace con clics: escribes tu usuario y contraseña de Fianly, seleccionas tu rol y verificas la conexión. \ \

Gateway Wompi

La integración Gateway Wompi conecta Yampi con Wompi, la pasarela de pagos de Bancolombia. A diferencia de las demás integraciones, esta no vive en las conversaciones: es parte del motor de cobros de la Tesorería de Yampi. Al configurarla, los cobros a tus inquilinos (canon, administración y otros conceptos) se procesan a través de tu propia cuenta de Wompi, con tus credenciales y tus tarifas, y el dinero llega directo a ti. ¿Qué es Wompi? Wompi es la pasarela de pagos de Bancolombia: una plataforma que permite a más de 30.000 comercios en Colombia recibir pagos en línea de forma segura. Acepta tarjetas de crédito y débito (Visa, Mastercard, American Express), pagos PSE desde cualquier banco, Nequi y transferencias con el Botón Bancolombia, entre otros medios. Para una inmobiliaria esto significa una cosa: tus inquilinos pueden pagar el arriendo con el medio que prefieran, y el recaudo entra a tu cuenta con el respaldo de Bancolombia. Qué es un "gateway" y qué tiene que ver con la Tesorería En Yampi, los gateways (Wompi, ePayco y Bold) son las pasarelas por donde viaja el dinero de la Tesorería, el módulo que gestiona los cobros a tus inquilinos. La relación es simple: - La Tesorería decide qué se cobra y a quién (el canon de julio, la administración, etc.). - El gateway decide por dónde se cobra: procesa el pago con la tarjeta o la cuenta del inquilino. Al conectar tu propio gateway, Yampi rutea los pagos por tu cuenta de Wompi. Esto tiene dos ventajas grandes: - El dinero es tuyo desde el primer momento: el recaudo entra a tu cuenta de Wompi (y de ahí a tu banco), no a una cuenta intermedia. - Tokenización de métodos de pago: Wompi guarda de forma segura la tarjeta o cuenta del inquilino y la convierte en un "token". Con ese token, los cobros recurrentes (como el arriendo de cada mes) se procesan automáticamente sin pedirle los datos de la tarjeta cada vez. Los datos reales nunca se almacenan en Yampi. Antes de empezar - Una cuenta de comercio activa en Wompi. Si no la tienes, créala en wompi.com. El registro es gratuito; las tarifas se cobran por transacción según tu plan. - Ser administrador en Yampi, para poder activar integraciones. - Acceso al panel de comercios de Wompi (comercios.wompi.co), de donde vas a copiar las llaves. Nota: Wompi maneja dos ambientes con llaves distintas. Las de Sandbox (empiezan por pub_test_, prv_test_) son para pruebas con dinero de juguete; las de Producción (pub_prod_, prv_prod_) mueven dinero real. Mezclarlas es la causa número uno de errores de conexión. Paso 1: copia tus llaves desde el panel de Wompi Este paso se hace fuera de Yampi: 1. Inicia sesión en comercios.wompi.co. 2. Entra a la sección Desarrolladores. 3. Ubica las Llaves del API: allí están la llave pública y la llave privada. 4. Ubica los Secretos para integración técnica: allí están el secreto de Eventos y el secreto de Integridad. Haz clic en mostrar para revelarlos. 5. Copia cada valor completo, sin espacios al inicio o al final. Verifica el prefijo: si vas a hacer pruebas, todos deben ser de test (pub_test_, prv_test_, test_events_, test_integrity_); si vas a cobrar de verdad, todos de producción (pub_prod_, prv_prod_, prod_events_, prod_integrity_). Importante: la llave privada y los secretos son confidenciales, como la clave de tu banco. No los compartas por chat ni correo, y pégalos únicamente en el formulario de Yampi. Paso 2: abre la integración en Yampi 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Gateway Wompi y haz clic en Configurar. Paso 3: completa el formulario de credenciales En la pantalla Gateway Wompi, activa el interruptor Habilitado (arriba a la derecha) y completa los campos: 1. Ambiente: selecciona Sandbox para hacer pruebas sin dinero real, o Producción para cobros reales. Empieza siempre en Sandbox si es tu primera configuración. 2. Llave pública: la llave pub_... que copiaste del panel de Wompi. Identifica tu comercio ante Wompi. 3. Llave privada: la llave prv_.... Es la que autoriza operaciones, por eso es confidencial. 4. Secreto webhook: el secreto con el que se validan las notificaciones de pago que llegan a Yampi, garantizando que vienen de Wompi y no de un tercero. 5. Llave de integridad: el secreto de Integridad (..._integrity_...) de Wompi. Firma cada transacción para que nadie pueda alterar el monto o la referencia en el camino. 6. Llave de eventos: el secreto de Eventos (..._events_...) de Wompi. Verifica la autenticidad de los eventos que Wompi reporta (pago aprobado, rechazado, etc.). 7. Token de aceptación: token asociado a la aceptación de los términos de tratamiento de datos de Wompi (exigencia de la ley colombiana de habeas data para procesar pagos). 8. URL sandbox y URL producción: las direcciones de la API de Wompi para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores estándar (https://sandbox.wompi.co/v1 y https://production.wompi.co/v1). Nota: todas las llaves deben pertenecer al mismo ambiente que seleccionaste arriba. Si eliges Producción pero pegas llaves pub_test_, la conexión fallará. Paso 4: prueba la conexión y guarda 1. Haz clic en Probar conexión. Yampi verifica las credenciales directamente contra Wompi antes de guardar nada. 2. Si la prueba es exitosa, haz clic en Guardar gateway. La tarjeta de Gateway Wompi en Integraciones pasará a mostrar la etiqueta Activado, y la Tesorería podrá rutear cobros por tu cuenta de Wompi. Si la prueba de conexión falla Revisa en este orden: 1. El ambiente y los prefijos: es el error más común. Ambiente Sandbox exige llaves ..._test_...; ambiente Producción exige llaves ..._prod_.... Todas las llaves del formulario deben ser del mismo juego. 2. Espacios de más: al copiar y pegar se cuela a veces un espacio al inicio o al final. Bórralo en cada campo. 3. Llaves incompletas: verifica que copiaste el valor completo desde el panel de Wompi (usa el botón mostrar y copia todo el texto). 4. El estado de tu cuenta en Wompi: si tu comercio es nuevo o está en revisión, algunos servicios pueden no estar activos todavía. Confírmalo en comercios.wompi.co o con el soporte de Wompi. Si las llaves son correctas y la prueba sigue fallando, escribe a soporte de Yampi indicando el mensaje de error. Sandbox: prueba sin arriesgar dinero El ambiente Sandbox de Wompi es una réplica exacta de la pasarela, pero con dinero de juguete: puedes simular pagos aprobados y rechazados para verificar que todo el flujo de cobro funciona. Ten en cuenta que los dos ambientes son independientes: las transacciones de Sandbox no existen en Producción, y viceversa. Cuando termines las pruebas, cambia el Ambiente a Producción y reemplaza todas las llaves por las de producción. Cómo deshabilitar el gateway 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Gateway Wompi. 2. Apaga el interruptor Habilitado y guarda. Los cobros dejan de rutearse por tu cuenta de Wompi. Tu cuenta de Wompi no se toca: tu historial y saldo siguen intactos en su plataforma. Preguntas frecuentes ¿Qué diferencia hay entre esta integración y las demás? Las demás integraciones potencian las conversaciones o sincronizan datos. Los gateways (Wompi, ePayco, Bold) son infraestructura de pagos: conectan la Tesorería de Yampi con la pasarela por donde se cobra a tus inquilinos. ¿Qué significa "tokenizar" un método de pago? Wompi guarda la tarjeta o cuenta del inquilino de forma segura y entrega a cambio un "token", un código que la representa. Los cobros recurrentes (como el arriendo mensual) se hacen con ese token, sin volver a pedir la tarjeta y sin que los datos reales pasen por Yampi. ¿El dinero pasa por Yampi? No. Los pagos se procesan directamente en tu cuenta de Wompi con tus propias credenciales. Yampi orquesta el cobro; el dinero va de tu inquilino a tu cuenta. ¿Cuánto cuesta? Yampi no cobra por activar el gateway. Wompi cobra sus tarifas por transacción según el plan que tengas con ellos; consúltalas en wompi.com. ¿Puedo probar antes de cobrar de verdad? Sí. Configura el ambiente Sandbox con las llaves de prueba y simula pagos con dinero de juguete. Cuando todo funcione, cambia a Producción con las llaves reales. ¿Qué pasa si cambio o regenero mis llaves en Wompi? La conexión dejará de funcionar con las llaves viejas. Vuelve a este formulario, pega las llaves nuevas, prueba la conexión y guarda. ¿Necesito saber programar? No. Todo se resuelve copiando y pegando las llaves desde el panel de Wompi. Los términos técnicos (llaves, secretos, tokens) son nombres que usa Wompi, pero el proceso son solo clics.

Gateway ePayco

La integración Gateway ePayco conecta Yampi con ePayco, una de las pasarelas de pago más usadas de Colombia. Al igual que Gateway Wompi, esta integración no vive en las conversaciones: es parte del motor de cobros de la Tesorería de Yampi. Al configurarla, los cobros a tus inquilinos (canon, administración y otros conceptos) se procesan a través de tu propia cuenta de ePayco, con tus credenciales y tus tarifas, y el dinero llega directo a ti. ¿Qué es ePayco? ePayco es una pasarela de pagos colombiana, respaldada por Davivienda, que permite a miles de comercios recibir pagos en línea. Acepta tarjetas de crédito y débito (Visa, Mastercard, American Express, Diners), pagos PSE desde cualquier banco, Daviplata y pagos en efectivo a través de puntos como Efecty, entre otros medios. Para una inmobiliaria esto significa una cosa: tus inquilinos pueden pagar el arriendo con el medio que prefieran —incluso en efectivo en un punto físico— y el recaudo entra a tu cuenta de ePayco. Qué es un "gateway" y qué tiene que ver con la Tesorería En Yampi, los gateways (Wompi, ePayco y Bold) son las pasarelas por donde viaja el dinero de la Tesorería, el módulo que gestiona los cobros a tus inquilinos. La relación es simple: - La Tesorería decide qué se cobra y a quién (el canon de julio, la administración, etc.). - El gateway decide por dónde se cobra: procesa el pago con la tarjeta o la cuenta del inquilino. Al conectar tu propio gateway, Yampi rutea los pagos por tu cuenta de ePayco. Esto tiene dos ventajas grandes: - El dinero es tuyo desde el primer momento: el recaudo entra a tu cuenta de ePayco (y de ahí a tu banco), no a una cuenta intermedia. - Tokenización de métodos de pago: ePayco guarda de forma segura la tarjeta del inquilino y la convierte en un "token". Con ese token, los cobros recurrentes (como el arriendo de cada mes) se procesan automáticamente sin pedirle los datos de la tarjeta cada vez. Los datos reales nunca se almacenan en Yampi. Antes de empezar - Una cuenta de comercio activa en ePayco. Si no la tienes, créala en epayco.com. El registro es gratuito; las tarifas se cobran por transacción según tu plan. - Ser administrador en Yampi, para poder activar integraciones. - Acceso al dashboard de ePayco (dashboard.epayco.com), de donde vas a copiar las llaves. Nota: para recibir pagos reales, tu cuenta de ePayco debe estar en modo Producción y con el proceso de verificación del comercio completado. Si tu cuenta es nueva y sigue en modo pruebas, los cobros reales no se procesarán. Paso 1: copia tus llaves desde el dashboard de ePayco Este paso se hace fuera de Yampi: 1. Inicia sesión en dashboard.epayco.com. 2. Entra a Integraciones → Llaves API. 3. Allí encontrarás las cuatro llaves que necesitas: PUBLIC_KEY (llave pública), PRIVATE_KEY (llave privada) y, en la sección de llaves secretas, P_CUST_ID_CLIENTE (tu Customer ID, el número que identifica tu comercio) y P_KEY. 4. Copia cada valor completo, sin espacios al inicio o al final. Importante: la llave privada y la P_KEY son confidenciales, como la clave de tu banco. No las compartas por chat ni correo, y pégalas únicamente en el formulario de Yampi. Paso 2: abre la integración en Yampi 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Gateway ePayco y haz clic en Configurar. Paso 3: completa el formulario de credenciales En la pantalla Gateway ePayco, activa el interruptor Habilitado (arriba a la derecha) y completa los campos: 1. URL sandbox y URL producción: las direcciones de la API de ePayco para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores por defecto. 2. Ambiente: selecciona Sandbox para hacer pruebas sin dinero real, o Producción para cobros reales. Empieza siempre en Sandbox si es tu primera configuración. 3. Llave pública: la PUBLIC_KEY que copiaste del dashboard de ePayco. Identifica tu comercio ante ePayco. 4. Llave privada: la PRIVATE_KEY. Es la que autoriza operaciones, por eso es confidencial. 5. Customer ID: el P_CUST_ID_CLIENTE, el número que identifica tu cuenta de comercio en ePayco. 6. P key: la P_KEY de ePayco. Firma las confirmaciones de transacción para verificar que ningún dato (monto, referencia) fue alterado en el camino. Mientras falten credenciales, verás un aviso amarillo en la parte superior: "Agrega las credenciales requeridas antes de cambiar Treasury a gateways propios de la cuenta". Es normal: desaparece cuando completas y guardas la configuración. Paso 4: prueba la conexión y guarda 1. Haz clic en Probar conexión. Yampi verifica las credenciales directamente contra ePayco antes de guardar nada. 2. Si la prueba es exitosa, haz clic en Guardar gateway. La tarjeta de Gateway ePayco en Integraciones pasará a mostrar la etiqueta Activado, y la Tesorería podrá rutear cobros por tu cuenta de ePayco. Si la prueba de conexión falla Revisa en este orden: 1. Espacios de más: al copiar y pegar se cuela a veces un espacio al inicio o al final. Bórralo en cada campo. 2. Llaves incompletas o intercambiadas: verifica que copiaste cada valor completo y en el campo correcto. Un error frecuente es pegar la P_KEY donde va la llave privada, o el Customer ID incompleto. 3. El ambiente: confirma que el selector Ambiente corresponde a lo que quieres hacer (pruebas o cobros reales). 4. El estado de tu cuenta en ePayco: si tu comercio es nuevo, está en revisión o sigue en modo pruebas, los servicios de producción pueden no estar activos todavía. Confírmalo en dashboard.epayco.com o con el soporte de ePayco. Si las llaves son correctas y la prueba sigue fallando, escribe a soporte de Yampi indicando el mensaje de error. Sandbox: prueba sin arriesgar dinero Con el ambiente Sandbox puedes simular pagos aprobados y rechazados para verificar el flujo de cobro completo sin mover dinero real. A diferencia de otras pasarelas, en ePayco las llaves son las mismas para pruebas y producción: lo que cambia es el modo en que se procesan las transacciones. Cuando termines las pruebas, cambia el Ambiente a Producción en Yampi y verifica que tu cuenta de ePayco esté en modo Producción y verificada. Cómo deshabilitar el gateway 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Gateway ePayco. 2. Apaga el interruptor Habilitado y guarda. Los cobros dejan de rutearse por tu cuenta de ePayco. Tu cuenta de ePayco no se toca: tu historial y saldo siguen intactos en su plataforma. Preguntas frecuentes ¿Qué diferencia hay entre esta integración y las demás? Las demás integraciones potencian las conversaciones o sincronizan datos. Los gateways (Wompi, ePayco, Bold) son infraestructura de pagos: conectan la Tesorería de Yampi con la pasarela por donde se cobra a tus inquilinos. ¿Qué significa "tokenizar" un método de pago? ePayco guarda la tarjeta del inquilino de forma segura y entrega a cambio un "token", un código que la representa. Los cobros recurrentes (como el arriendo mensual) se hacen con ese token, sin volver a pedir la tarjeta y sin que los datos reales pasen por Yampi. ¿El dinero pasa por Yampi? No. Los pagos se procesan directamente en tu cuenta de ePayco con tus propias credenciales. Yampi orquesta el cobro; el dinero va de tu inquilino a tu cuenta. ¿Cuánto cuesta? Yampi no cobra por activar el gateway. ePayco cobra sus tarifas por transacción según el plan que tengas con ellos; consúltalas en epayco.com. ¿Mis inquilinos pueden pagar en efectivo? Sí, esa es una de las ventajas de ePayco: además de tarjetas, PSE y Daviplata, admite pagos en efectivo en puntos como Efecty. La disponibilidad de cada medio depende de tu plan con ePayco. ¿Qué pasa si cambio o regenero mis llaves en ePayco? La conexión dejará de funcionar con las llaves viejas. Vuelve a este formulario, pega las llaves nuevas, prueba la conexión y guarda. ¿Necesito saber programar? No. Todo se resuelve copiando y pegando las llaves desde el dashboard de ePayco. Los términos técnicos (PUBLIC_KEY, P_KEY, Customer ID) son nombres que usa ePayco, pero el proceso son solo clics.

Gateway Bold

La integración Gateway Bold conecta Yampi con Bold, la fintech colombiana conocida por sus datáfonos y su pasarela de pagos en línea. Al igual que Gateway Wompi y Gateway ePayco, esta integración no vive en las conversaciones: es parte del motor de cobros de la Tesorería de Yampi. Al configurarla, los cobros a tus inquilinos (canon, administración y otros conceptos) se procesan a través de tu propia cuenta de Bold, con tus credenciales y tus tarifas, y el dinero llega directo a ti. ¿Qué es Bold? Bold es una empresa colombiana de pagos que se hizo conocida por sus datáfonos para pequeños y medianos negocios, y que hoy también ofrece una pasarela de pagos en línea completa. Acepta tarjetas de crédito y débito (Visa, Mastercard, entre otras), pagos PSE desde cualquier banco, Nequi y otras billeteras, e incluso cobros internacionales con conversión de moneda. Para una inmobiliaria esto significa una cosa: tus inquilinos pueden pagar el arriendo con el medio que prefieran, y el recaudo entra a tu cuenta de Bold. Qué es un "gateway" y qué tiene que ver con la Tesorería En Yampi, los gateways (Wompi, ePayco y Bold) son las pasarelas por donde viaja el dinero de la Tesorería, el módulo que gestiona los cobros a tus inquilinos. La relación es simple: - La Tesorería decide qué se cobra y a quién (el canon de julio, la administración, etc.). - El gateway decide por dónde se cobra: procesa el pago con la tarjeta o la cuenta del inquilino. Al conectar tu propio gateway, Yampi rutea los pagos por tu cuenta de Bold. Esto tiene dos ventajas grandes: - El dinero es tuyo desde el primer momento: el recaudo entra a tu cuenta de Bold (y de ahí a tu banco), no a una cuenta intermedia. - Tokenización de métodos de pago: la pasarela guarda de forma segura la tarjeta del inquilino y la convierte en un "token". Con ese token, los cobros recurrentes (como el arriendo de cada mes) se procesan automáticamente sin pedirle los datos de la tarjeta cada vez. Los datos reales nunca se almacenan en Yampi. Antes de empezar - Una cuenta de comercio activa en Bold. Si no la tienes, créala en bold.co. El registro es gratuito; Bold cobra sus tarifas por transacción. - Ser administrador en Yampi, para poder activar integraciones. - Acceso al panel de comercios de Bold (panel.bold.co), de donde vas a copiar las llaves. Nota: Bold entrega llaves separadas para pruebas y producción. Las de producción solo aparecen cuando tu comercio ha sido verificado por el equipo de Bold. Si tu cuenta es nueva y aún no está verificada, podrás hacer pruebas, pero no recibir pagos reales. Paso 1: copia tus llaves desde el panel de Bold Este paso se hace fuera de Yampi: 1. Inicia sesión en panel.bold.co con la cuenta del comercio que quieres conectar. 2. En el menú lateral, entra a la sección Integraciones. 3. Si es tu primera vez, haz clic en Activar llaves; en unos segundos aparecerán las llaves. Selecciona el tipo de integración API. 4. Verás dos llaves por ambiente: la llave de identidad (también llamada API key: es pública e identifica tu comercio) y la llave secreta (privada: garantiza la seguridad de la comunicación con Bold). 5. Copia cada valor completo, sin espacios al inicio o al final, empezando por las llaves del ambiente en que vas a trabajar (pruebas o producción). Importante: la llave secreta es confidencial, como la clave de tu banco. No la compartas por chat ni correo, y pégala únicamente en el formulario de Yampi. Paso 2: abre la integración en Yampi 1. Haz clic en el ícono de engranaje (Ajustes) en la parte inferior de la barra lateral izquierda. 2. En el menú de Ajustes, haz clic en Integraciones. 3. Ubica la tarjeta Gateway Bold y haz clic en Configurar. Paso 3: completa el formulario de credenciales En la pantalla Gateway Bold, activa el interruptor Habilitado (arriba a la derecha) y completa los campos: 1. URL sandbox y URL producción: las direcciones de la API de Bold para cada ambiente. Salvo indicación contraria de soporte, déjalas con sus valores por defecto. 2. Ambiente: selecciona Sandbox para hacer pruebas sin dinero real, o Producción para cobros reales. Empieza siempre en Sandbox si es tu primera configuración. 3. Llave privada: la llave secreta de Bold. Es la que autoriza operaciones, por eso es confidencial. 4. Llave pública: la llave de identidad (API key) que copiaste del panel de Bold. Identifica tu comercio ante Bold. 5. Secreto webhook: el secreto con el que se validan las notificaciones de pago que llegan a Yampi, garantizando que vienen de Bold y no de un tercero. Atención: en Bold las llaves de pruebas y de producción son distintas. Asegúrate de que las llaves que pegas correspondan al ambiente que seleccionaste: llaves de pruebas con Sandbox, llaves de producción con Producción. Mientras falten credenciales, verás un aviso amarillo en la parte superior: "Agrega las credenciales requeridas antes de cambiar Treasury a gateways propios de la cuenta". Es normal: desaparece cuando completas y guardas la configuración. Paso 4: prueba la conexión y guarda 1. Haz clic en Probar conexión. Yampi verifica las credenciales directamente contra Bold antes de guardar nada. 2. Si la prueba es exitosa, haz clic en Guardar gateway. La tarjeta de Gateway Bold en Integraciones pasará a mostrar la etiqueta Activado, y la Tesorería podrá rutear cobros por tu cuenta de Bold. Si la prueba de conexión falla Revisa en este orden: 1. Espacios de más: al copiar y pegar se cuela a veces un espacio al inicio o al final. Bórralo en cada campo. 2. Llaves de otro ambiente: es el error más común con Bold. Si el selector está en Sandbox pero pegaste las llaves de producción (o al revés), la prueba falla. Verifica que ambiente y llaves coincidan. 3. Llaves incompletas o intercambiadas: verifica que copiaste cada valor completo y en el campo correcto (la llave de identidad en Llave pública, la secreta en Llave privada). 4. El estado de tu cuenta en Bold: si tu comercio aún no ha sido verificado, las llaves de producción no estarán disponibles. Confírmalo en panel.bold.co o con el soporte de Bold. Si las llaves son correctas y la prueba sigue fallando, escribe a soporte de Yampi indicando el mensaje de error. Sandbox: prueba sin arriesgar dinero Con el ambiente Sandbox puedes simular pagos aprobados y rechazados para verificar el flujo de cobro completo sin mover dinero real, usando las llaves de pruebas de Bold. Cuando todo funcione, cambia el Ambiente a Producción, reemplaza las llaves por las de producción (recuerda: en Bold son distintas), vuelve a probar la conexión y guarda. Cómo deshabilitar el gateway 1. Ve a Ajustes → Integraciones y haz clic en Configurar en la tarjeta Gateway Bold. 2. Apaga el interruptor Habilitado y guarda. Los cobros dejan de rutearse por tu cuenta de Bold. Tu cuenta de Bold no se toca: tu historial y saldo siguen intactos en su plataforma. Preguntas frecuentes ¿Qué diferencia hay entre esta integración y las demás? Las demás integraciones potencian las conversaciones o sincronizan datos. Los gateways (Wompi, ePayco, Bold) son infraestructura de pagos: conectan la Tesorería de Yampi con la pasarela por donde se cobra a tus inquilinos. Ya uso el datáfono de Bold en mi oficina, ¿me sirve la misma cuenta? Sí. La cuenta de comercio de Bold es una sola: la misma que usas para el datáfono te sirve para los pagos en línea. Solo necesitas activar las llaves de integración en panel.bold.co. ¿Qué significa "tokenizar" un método de pago? La pasarela guarda la tarjeta del inquilino de forma segura y entrega a cambio un "token", un código que la representa. Los cobros recurrentes (como el arriendo mensual) se hacen con ese token, sin volver a pedir la tarjeta y sin que los datos reales pasen por Yampi. ¿El dinero pasa por Yampi? No. Los pagos se procesan directamente en tu cuenta de Bold con tus propias credenciales. Yampi orquesta el cobro; el dinero va de tu inquilino a tu cuenta. ¿Cuánto cuesta? Yampi no cobra por activar el gateway. Bold cobra sus tarifas por transacción según las condiciones de tu cuenta; consúltalas en bold.co. ¿Qué pasa si cambio o regenero mis llaves en Bold? La conexión dejará de funcionar con las llaves viejas. Vuelve a este formulario, pega las llaves nuevas, prueba la conexión y guarda. ¿Necesito saber programar? No. Todo se resuelve copiando y pegando las llaves desde el panel de Bold. Los términos técnicos (llave de identidad, API key) son nombres que usa Bold, pero el proceso son solo clics.