v1.0 — Estable

Documentación

Todo lo que necesitas para integrar Recepción Inteligente en tu aplicación, automatizar flujos de trabajo y construir encima de nuestra plataforma.

Inicio rápido

De cero a atendiendo clientes en menos de 25 minutos.

Crea tu cuenta

2 min

Regístrate en recepcioninteligente.com con tu email. El proceso toma menos de 2 minutos.

Conecta WhatsApp

5 min

Escanea el QR desde tu WhatsApp Business o usa la API de Meta Cloud para producción.

Configura tu IA

10 min

Define el nombre, tono y especialidad de tu asistente. Agrega tus preguntas frecuentes.

Activa tu agenda

5 min

Establece tu horario de disponibilidad y activa las reservas automáticas.

Prueba y lanza

2 min

Envía un mensaje de prueba a tu número y verifica que todo funciona. ¡Listo!

Autenticación

Todas las peticiones a la API requieren un token JWT de tipo Bearer.

# Obtén tu token haciendo POST a /api/auth/login

POST /api/auth/login

{

"email": "tu@email.com",

"password": "tu-contraseña"

}

# Usa el token en el header Authorization

Authorization: Bearer <access_token>

Nota: Los tokens de acceso expiran en 30 minutos. Usa el /api/auth/refresh con tu refresh_token para renovarlos sin re-login.

API REST

URL base: https://api.recepcioninteligente.com/api/v1

Todos los endpoints devuelven JSON. Los errores siguen el formato { detail: string }.

MétodoEndpointDescripción

GET/api/v1/conversacionesListar conversaciones activas

POST/api/v1/conversacionesCrear nueva conversación

GET/api/v1/citasListar citas del médico

POST/api/v1/citasCrear nueva cita

PATCH/api/v1/citas/{id}Actualizar estado de cita

GET/api/v1/pacientesListar pacientes/clientes

POST/api/v1/pacientesCrear nuevo paciente

GET/api/v1/leadsListar leads del CRM

POST/api/v1/leadsCrear nuevo lead

GET/api/v1/config/botObtener configuración de la IA

PUT/api/v1/config/botActualizar configuración de la IA

Ver referencia completa de la API

Webhooks

Recibe notificaciones en tiempo real en tu servidor cuando ocurren eventos en la plataforma. Configura tu URL en Ajustes → Integraciones → Webhooks.

cita.creada

Se dispara cuando un paciente agenda una nueva cita.

cita.cancelada

Se dispara cuando se cancela o reprograma una cita.

lead.nuevo

Se dispara cuando la IA captura un nuevo lead.

mensaje.recibido

Se dispara al recibir un mensaje entrante por WhatsApp.

conversacion.cerrada

Se dispara cuando una conversación se marca como resuelta.

Integraciones

Conecta Recepción Inteligente con las herramientas que ya usas.

Google Calendar

Disponible

Sincroniza citas en tiempo real con tu Google Calendar.

Zapier

Disponible

Conecta con más de 5,000 apps via Zapier y Webhooks.

Meta Cloud API

Disponible

WhatsApp Business API oficial para alto volumen.

Stripe

Disponible

Cobra anticipos y pagos directamente por WhatsApp.

Make (Integromat)

Beta

Automatizaciones visuales con Make.

HubSpot CRM

Próximamente

Sincronización bidireccional con HubSpot.

SDKs & Librerías

JavaScript / Node.js

Disponible

npm install @recepcion-inteligente/sdk

Python

Disponible

pip install recepcion-inteligente

PHP

Beta

composer require recepcion/sdk

Límites & Cuotas

Límite	Básico	Profesional	Premium
Peticiones API / hora	500	2,000	10,000
Webhooks activos	2	10	Ilimitados
Conversaciones / mes	500	2,000	Ilimitadas
Miembros del equipo	1	5	Ilimitados
Canales WhatsApp	1	3	Ilimitados
Retención de datos	3 meses	12 meses	Indefinida