Перейти к основному содержимому

Клиники и недвижимость

Два отраслевых коннектора, у каждого есть шаблонный сценарий. Установите их в разделе Консоль, Админ, Интеграции; учётные данные запечатываются ключом компании и больше не показываются.

Клиники: Doctoralia​

Коннектор doctoralia (категория healthcare). ИИ-агент получает три инструмента, int_doctoralia_find_slots, int_doctoralia_book и int_doctoralia_cancel, и шаблонный сценарий pbx/crates/flows/templates/clinic-reception.json (меню, ИИ-агент записи, очередь регистратуры, голосовая почта; каждая ветка заканчивается регистратурой). Шаблон агента clinic уже содержит защитные подсказки emergency и no_medical_advice; стойка ниже применяет те же правила в коде.

НастройкаЗначениеПо умолчанию
domainсайт страны: doctoralia.com.mx, .com.br, .com.ar, .cl, .com.co, .pe, .es, .itобязательно
facility_id, doctor_id, address_idрасписание, на которое идёт записьобязательно
service_idтип приёмаприём по умолчанию
timezoneзона IANA клиникиAmerica/Mexico_City
max_days_ahead / min_notice_minutesгоризонт записи и минимальное время до приёма60 дней / 60 минут
max_per_phone_dayсколько записей может сделать один номер в день3
country_codeдополняет национальные номера до E.16452
escalate_toвнутренний номер или очередь, куда агент передаёт звонокнет

Секреты: client_id и client_secret интеграционного приложения Docplanner.

Защитные правила (clinic::guard, clinic::desk):

  • Текст, похожий на неотложное состояние (боль в груди, не могу дышать, передозировка, кровотечение, потеря сознания, суицид и подобное на испанском, английском и португальском), отклоняется с escalate: true и escalate_to; агент передаёт звонок сотрудникам. Просьба о диагнозе, рецепте, дозировке или результате анализа отклоняется с reason: medical_advice.
  • Причина визита и заметка проверяются и никогда не отправляются в Doctoralia; из АТС уходят только имя и телефон.
  • Слот бронируется, только если платформа всё ещё предлагает его непосредственно перед записью; ответ 409 означает то же самое.
  • Срок предупреждения и горизонт соблюдаются; один номер может записаться max_per_phone_day раз в день.
  • Для отмены нужен номер телефона, с которого сделана запись (сравниваются последние десять цифр); три неверных номера блокируют запись и передают её сотрудникам.

Стойка работает через трейт clinic::provider::BookingProvider, поэтому другая система записи реализует те же четыре вызова.

Недвижимость: Inmuebles24​

Коннектор inmuebles24 (категория realestate), шаблонный сценарий real-estate-leads.json, инструмент int_inmuebles24_listing (цена, площадь, комнаты, район; без данных владельца). Создайте точку входящих хуков для коннектора (см. Исходящие вебхуки, схема shared_secret) и передайте её адрес порталу.

Каждая заявка (id, posting, contact, message) обрабатывается один раз (realestate::desk::LeadDesk):

  1. Телефон приводится к E.164 (включая старые мексиканские формы 044/045/+521); заявка без пригодного номера только получает ответ.
  2. Ответ уходит заявителю сразу, на es, en или pt либо по reply_template администратора ({name}, {title}, {url}, {when}).
  3. Обратный звонок ИИ-агента ставится в очередь через callback_delay_minutes, сдвигается в рабочие часы (open, close, days, timezone; ничего не начинается в последние десять минут). Номера из списка «не звонить» не вызываются никогда, а вторая заявка с того же номера по тому же объявлению получает ответ, но повторный звонок не делается.
  4. Если шаг не удался, входящий ящик повторяет заявку, и выполняется только недостающий шаг. Сообщение потенциального клиента попадает к агенту только внутри ограждённой справки, помеченной как данные.

До следующего выпуска состояние хранится в памяти. Миграции и новых таблиц нет.