Skip to main content
La Guía para desarrolladores de Visito está dirigida a equipos que crean integraciones de servidor: CRM, PMS, herramientas internas, agentes de IA, reportes y automatizaciones operativas. La API machine-to-machine permite consultar canales conectados, sincronizar conversaciones, enviar respuestas, administrar herramientas personalizadas de IA y enviar plantillas aprobadas de WhatsApp.

​
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

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.

Configurar autenticación M2M

Crea credenciales, asigna scopes y autentica solicitudes de servidor.