Хуки сенсея
match-contacts-and-fill-data
Описание
Хук находит контакты сделки по имени и записывает их данные в локальные параметры процесса Sensei.
Как это работает:
1. Вы передаёте имена контактов в параметрах
2. Хук ищет контакты сделки с такими именами (точное совпадение)
3. Найденные данные записываются в локальные параметры процесса по конвенции:
Пример: у сделки есть 2 контакта — "Николай" и "Василий Иванович". Вы передаёте
Как это работает:
1. Вы передаёте имена контактов в параметрах
c1_name, c2_name и т.д.
2. Хук ищет контакты сделки с такими именами (точное совпадение)
3. Найденные данные записываются в локальные параметры процесса по конвенции:
c{N}_id, c{N}_phone, c{N}_email, c{N}_cf{ID}Пример: у сделки есть 2 контакта — "Николай" и "Василий Иванович". Вы передаёте
c1_name=Николай и c2_name=Василий Иванович, хук находит эти контакты и записывает их ID, телефон, email и кастомные поля в локальные параметры c1_id, c1_phone, c2_id, c2_phone и т.д.Важно знать
Точное совпадение имени. Поиск контакта происходит по точному совпадению имени, включая регистр и пробелы.
Пример: если в amoCRM контакт называется "Николай Иванов", то
Пример: если в amoCRM контакт называется "Николай Иванов", то
c1_name=николай иванов или c1_name=Николай — не найдут этот контакт.Сценарии использования
Сценарий 1: Все контакты найдены
Вы передали
Результат:
Вы передали
c1_name=Николай и c2_name=Василий. Оба контакта найдены в сделке.
Результат:
success. Все локальные параметры заполнены данными контактов.Сценарий 2: Часть контактов не найдена
Вы передали
Результат:
Вы передали
c1_name=Николай и c2_name=Пётр. Контакт "Николай" найден, а "Пётр" — нет.
Результат:
contacts_not_found. Локальные параметры не заполняются.Сценарий 3: Ни один контакт не найден
Вы передали
Результат:
Вы передали
c1_name=Пётр и c2_name=Иван. Ни одного контакта с такими именами в сделке нет.
Результат:
contacts_not_found. Локальные параметры не заполняются.Сценарий 4: Не передан обязательный параметр c1_name
Запрос не содержит параметр
Результат: Хук не будет вызван, запрос не пройдёт валидацию.
Запрос не содержит параметр
c1_name.
Результат: Хук не будет вызван, запрос не пройдёт валидацию.
Требования для работы хука
URL
https://octane.pushka.biz/sensei/match-contacts-and-fill-data
Обязательные параметры
c1_name
Текст
Имя первого контакта для поиска. Должно точно совпадать с именем контакта в amoCRM.
Дополнительные параметры
c2_name
Текст
Имя второго контакта для поиска.
c3_name
Текст
Имя третьего контакта для поиска.
c4_name
Текст
Имя четвёртого контакта для поиска.
c5_name
Текст
Имя пятого контакта для поиска.
Локальные параметры процесса
Для каждого контакта c{N} создайте нужные локальные параметры:
c{N}_id
Текст
ID контакта в amoCRM.
c{N}_name
Текст
Имя контакта.
c{N}_phone
Текст
Телефон контакта (первое значение поля PHONE).
c{N}_email
Текст
Email контакта (первое значение поля EMAIL).
c{N}_cf{ID}
Текст
Значение кастомного поля контакта, где
{ID} — ID поля в amoCRM. Пример: c1_cf716915Ответы хука
Хук возвращает следующие ответы в Sensei:
success
Все переданные контакты найдены, данные записаны в локальные параметры.contacts_not_found
Хотя бы один из переданных контактов не найден по имени. Данные найденных контактов всё равно записываются.fail
Произошла ошибка. Обратитесь к разработчику.