Saltar al contenido principal
Conecta tus sistemas con Visito para integrar conversaciones, asistencia de IA y operaciones en un mismo flujo de trabajo. Usa la API desde tu backend, permite que la IA invoque tus herramientas y reacciona a los cambios con webhooks.

​
Qué puedes crear

Canales y conversaciones

Consulta canales conectados e historiales y envía respuestas en conversaciones existentes.Casos de uso: Crea una bandeja de soporte, muestra el contexto de las conversaciones en tu CRM o permite que tu equipo responda desde una herramienta interna.

Plantillas de WhatsApp

Crea, consulta y envía plantillas aprobadas de WhatsApp mediante canales conectados.Casos de uso: Envía recordatorios de citas, actualizaciones de pedidos o avisos de servicio desde tu backend, siguiendo los requisitos de aprobación y mensajería de WhatsApp.

IA y atención humana

Controla la participación de la IA, asigna operadores, consulta transferencias y devuelve conversaciones resueltas a la IA.Casos de uso: Asigna un caso escalado a un especialista o pausa la IA mientras tu equipo o un sistema externo atiende la conversación.

Entrega de mensajes

Consulta una solicitud de envío aceptada y el estado de entrega de sus mensajes.Casos de uso: Muestra el progreso de entrega en tu aplicación e identifica avisos fallidos para revisarlos. Una solicitud en cola no confirma la entrega.

Conocimiento

Administra los textos, archivos y sitios web que tu agente utiliza para responder preguntas.Casos de uso: Publica preguntas frecuentes desde tu CMS, carga manuales o actualiza el contenido de tu sitio cuando cambien tus políticas. Verifica el estado de procesamiento y la activación de las fuentes.

Herramientas personalizadas de IA

Da a tu agente acceso a datos en tiempo real y acciones implementadas en tu backend.Casos de uso: Consulta un pedido, verifica disponibilidad, recupera puntos de lealtad o crea un ticket durante una conversación. Tu backend implementa la lógica y los permisos.

Comercio

Administra artículos del catálogo y consulta ventas para sincronizarlas con tus sistemas.Casos de uso: Mantén productos, servicios y complementos alineados con tu catálogo o importa ventas a tus procesos de entrega y contabilidad.

CRM de ventas

Consulta la configuración publicada del pipeline, oportunidades, actividad, contactos y seguimientos; actualiza campos o etapas de oportunidades.Casos de uso: Sincroniza oportunidades con tu CRM, crea un panel de ventas o actualiza una oportunidad existente después de calificarla en tu sistema. Los seguimientos se pueden consultar.

Negocios y ubicaciones

Consulta los negocios o unidades operativas configurados en tu cuenta de Visito.Casos de uso: Relaciona los identificadores de Visito con las ubicaciones de tu sistema y utiliza el negocio correspondiente al configurar artículos o herramientas por negocio.

Reportes

Consulta resúmenes de mensajería, métricas diarias y totales por canal para un periodo.Casos de uso: Crea un reporte operativo semanal, compara la actividad por canal o agrega tendencias de mensajería a tu panel de análisis.

Webhooks

Recibe notificaciones firmadas sobre mensajes nuevos, cambios de entrega, transferencias y cambios en oportunidades de venta.Casos de uso: Activa tu integración cuando algo cambie: crea una tarea, actualiza tu CRM o muestra el progreso de entrega. Los eventos contienen identificadores y metadatos; consulta el contenido mediante la API.

​
Combina capacidades en un flujo de trabajo

Si tu integración responde automáticamente, activa el modo manual antes de procesar eventos entrantes para coordinarla con Visito AI. La guía de control de conversaciones explica el control de la conversación y el seguimiento de entrega.

​
Elige por dónde empezar

​
URL base

Todas las solicitudes deben realizarse desde un backend. No llames a la API M2M desde código de navegador, aplicaciones móviles ni widgets incrustados.

​
Definición OpenAPI

Consulta la Referencia de API para ver parámetros, esquemas de solicitudes y respuestas, scopes y solicitudes interactivas. Usa estas guías para los flujos de integración y ejemplos. Usa la definición OpenAPI como fuente para generar clientes, validar datos y dar contexto a asistentes de programación. La especificación contiene las rutas actuales, scopes, parámetros, cuerpos, respuestas y errores estructurados.
Si un endpoint no aparece en la definición OpenAPI actual o en la Guía para desarrolladores, considéralo no disponible.

​
Conceptos principales

  • Tenant: cuenta de negocio a la que pertenece una credencial M2M.
  • Canal: destino conectado de WhatsApp, Instagram, Messenger o Webchat.
  • Conversación: hilo entre un usuario externo y un tenant de Visito.
  • Credencial M2M: clave de servidor con scopes explícitos.
  • Idempotency-Key: encabezado que evita envíos duplicados cuando una solicitud se reintenta.

​
Patrón de solicitud

Las operaciones de envío también requieren una clave de idempotencia:

​
Primeros pasos

1

Crear una clave M2M

Genera una credencial en el dashboard de Visito con únicamente los scopes que necesita tu integración.
2

Consultar los canales

Llama a GET /m2m/v1/channels y guarda el channelId del canal que utilizarás.
3

Sincronizar conversaciones

Usa GET /m2m/v1/conversations para cargar conversaciones en tu CRM o backend.
4

Enviar de forma segura

Incluye Idempotency-Key en cada envío y guarda los identificadores devueltos para conciliar el estado.