Saltar al contenido principal

Clínicas e inmobiliarias

Dos conectores por sector, cada uno con un flujo de plantilla. Instálelos desde Consola, Admin, Integraciones; las credenciales se sellan con la llave de la empresa y no se vuelven a mostrar.

Clínicas: Doctoralia​

Conector doctoralia (categoría healthcare). El agente de IA recibe tres herramientas, int_doctoralia_find_slots, int_doctoralia_book e int_doctoralia_cancel, y el flujo de plantilla pbx/crates/flows/templates/clinic-reception.json (menú, agente de IA para citas, cola de recepción, buzón de voz; toda rama termina en recepción). La plantilla de agente clinic ya incluye las protecciones de aviso emergency y no_medical_advice; la recepción de abajo aplica las mismas reglas en código.

AjusteSignificadoPredeterminado
domainsitio del país: doctoralia.com.mx, .com.br, .com.ar, .cl, .com.co, .pe, .es, .itobligatorio
facility_id, doctor_id, address_idla agenda en la que se reservaobligatorio
service_idtipo de consulta que se reservala consulta predeterminada
timezonezona IANA de la clínicaAmerica/Mexico_City
max_days_ahead / min_notice_minuteshorizonte de reservación y aviso mínimo60 días / 60 minutos
max_per_phone_dayreservaciones que un número puede hacer por día3
country_codecompleta los números nacionales a E.16452
escalate_toextensión o cola a la que el agente pasa la llamadaninguna

Secretos: client_id y client_secret de la aplicación de integración de Docplanner.

Protecciones (clinic::guard, clinic::desk):

  • El texto que suena a emergencia (dolor de pecho, no puedo respirar, sobredosis, hemorragia, inconsciente, suicidio y similares en español, inglés y portugués) se rechaza con escalate: true y escalate_to; el agente pasa la llamada al personal. Una solicitud de diagnóstico, receta, dosis o resultado de estudio se rechaza con reason: medical_advice.
  • El motivo de la consulta y la nota se revisan y nunca se envían a Doctoralia; de la PBX solo salen el nombre y el teléfono.
  • Un horario se reserva solo si la plataforma aún lo ofrece justo antes de escribir; un 409 es la misma respuesta.
  • Se aplican el aviso mínimo y el horizonte; un número puede reservar max_per_phone_day veces al día.
  • Cancelar requiere el número de teléfono con el que se hizo la reservación (se comparan los últimos diez dígitos); tres números incorrectos bloquean la reservación y la pasan al personal.

La recepción habla con el trait clinic::provider::BookingProvider, de modo que otro sistema de citas implementa las mismas cuatro llamadas.

Inmobiliarias: Inmuebles24​

Conector inmuebles24 (categoría realestate), flujo de plantilla real-estate-leads.json, herramienta int_inmuebles24_listing (precio, tamaño, recámaras, colonia; sin datos del propietario). Cree un endpoint de hooks entrantes para el conector (vea Webhooks salientes, esquema shared_secret) y entregue su dirección al portal.

Cada publicación de prospecto (id, posting, contact, message) se procesa una sola vez (realestate::desk::LeadDesk):

  1. El teléfono se normaliza a E.164 (incluidas las formas mexicanas antiguas 044/045/+521); una publicación sin número utilizable solo recibe respuesta.
  2. Se responde de inmediato al prospecto, en es, en o pt o con la reply_template del administrador ({name}, {title}, {url}, {when}).
  3. Una devolución de llamada del agente de IA se pone en cola callback_delay_minutes después, movida dentro del horario de atención (open, close, days, timezone; nada empieza en los últimos diez minutos). Los números de la lista de no llamar nunca se marcan, y un segundo prospecto del mismo número sobre el mismo anuncio recibe respuesta pero no otra llamada.
  4. Si un paso falla, el buzón reintenta la publicación y solo se ejecuta el paso faltante. El mensaje del prospecto llega al agente solo dentro de un resumen delimitado y marcado como datos.

El estado se guarda en memoria hasta una versión posterior. No hay migración ni tabla nueva.