> For the complete documentation index, see [llms.txt](https://chatme-ai-4.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatme-ai-4.gitbook.io/docs/kak-vyvesti-agenta-v-konechnye-kanaly/vyvod-agenta-v-omnikanalnye-platformy/edna-chat-center.md). # Edna Chat Center [Edna](https://edna.ru/) – одна из омниканальных платформ для общения с клиентами в текстовых каналах. Вы можете использовать её в качестве канала для публикации вашего Агента в качестве бота-оператора. Ознакомиться с пользовательской документацией вы можете по [этой ссылке](https://fdd.edna.ru/d/051dbdaf4959450683bf/). > Важно: Подключение бота в каналы общения происходит через техподдержку Edna. ## Подключение ### 1. Конфигурация бота на стороне Edna В первую очередь нужно произвести конфигурацию на стороне Edna. 1. Авторизуйтесь в Edna как администратор. 2. Перейдите в раздел Настройка → Чат-бот. 3. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-WbaNpak53y/60e00449c319385784bd969960b12ed58b66ad998cbf31650ee07906de1ff7fc56242b822d63bd1a13e04c6816da3b336662de1b517982200352498cbfc3304e73e98ec52e368774f7f91f31070d83f384fabdea93c0c0c4ea0973b79898b4ac9ea35609) 4. Создайте нового бота и заполните следующие поля: 5. 1. Имя чат-бота — любое удобное имя. 2. URL бекенда чат-бота для обработки сообщений клиента — URL полученный при конфигурации бота на платформе. 3. URL бекенда чат-бота для инициации диалога с клиентом — URL полученный при конфигурации бота на платформе. 4. Таймаут ожидания ответа чат-бота — время, при отсутствии ответа чат-бота, по истечении которого обращение распределяется в соответствии со следующим правилом, указанным в маршрутизации. 5. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-tQmB9oCkT4/a2e1f43f394a7997d8f415da41743fb56216576db1bdd3fd08e627ec5968e7c2e38d63770b0cecd0703e20c9f9f2dcd00c328216e29c47142b5ff3d629ad7f63625567c4e4f25f3a407f6f9e3cb1a411eb924aced950c6d098c640addf0d00bde60e27b3) 6. Создайте токен используя кнопку +Token и запишите его. Он понадобится при настройке канала агента на платформе. Эта кнопка появляется при наведении курсора на поле с именем и настройками нужного Бота. 7. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-o1Om2eE8ZO/81a19b35e4f2f4d6102cd751b16a5175ae66c936911ef7b71fd6b26a71163ba95adbedd8eb00e707209bc574926fa3d47121fdee0985e9910df12d268447c3ca96be1e280893eaaaecc4aefc4d72ced4e5e13859aae3de94f6464f487e6a3ff2d7c5186b) На этом конфигурация Бота в Edna завершена. ### 2. Конфигурация канала агента в Платформе Агенту необходимо создать и настроить Канал Проекта с Коннектором “Edna Chat Center”. 1. Кликните по кнопке настроек Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m_bL4GvN1_/de0e6c51b47058d8e7854370e44e3e29e8d1195855e34484c55e0ba55e6f4cbc2f103ac4ebcc2b78bf606d6b02118303275d07760b64f89e5ea954cd86466379ab9850814435bbe8d5ab7d3e80e7ac68c8a471b3ba0022e97fb3209a771f11a86b6c817e) 2. Нажмите кнопку Add channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-KJ7zJqauLN/e76804ae1c32c84507914bcbac89b59e5fa7160e857084643655c65f3192dbec4709a2cd8abae87edc6a858acbd80d17c3296d23c47a2c39eccf56433201a9779ccf4ea2580c347508e5f68b0ee94654585fa349ceadd2e6587a4bdebd6c5d9715835322) 3. Откроется панель выбора Конечный канал.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-NBTL42jgi6/9c18a41382b5c02473b54f1fd306397da9c10b7166718388bd21fc9e9a2032f956a63ef991b0b10188e0d863d5fb6b916bbeecc7afd08f68dc8e1a1f18912d7571ac39ee9596b9d5af9107438ade7a64404e3c3c1cbff2c040a82f092596a83825b81e7a) 4. Выберите Edna Chat Center. 5. Откроется панель создания Канал Проекта.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-UlTB1B6rEB/42bf3d542f492c94b6e1544a026d0c2d52ed9941959717e36426fdb37455ee3c730b7817770a3517bab3dd04258b484e1bcd7dc1c8b569ce59bc8586520781bd605e1da09df6bcfbc8c539813bcdc483df3fe7eee38e21278c8c711624cfeed1cc9b8cff) 6. По необходимости пропишите заголовок для данного Канал Проекта в поле названия с плейсхолдером New channel.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-D381J6Lnal/92caeaad7c061579a777da91501cb18f87c550cdcae1065affda5f600805cbac11e048bad10e41dd0e991b23c6610ae9058c201b514e40322f7b255d8ff13f3c86ed90c6f6886158933833516e270b262a7a124b022f997e253cc3d162c6dd57d2b50d46) 7. Пропишите адрес для вашего аккаунта в поле Edna Chat Center webhook URL в виде https\://\.\/api/v1/chatbot, где \ - имя поддомена вашего аккаунта Edna, а \ - имя домена Edna(threads.im либо edna.io).\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-IRPvmk-XAu/ad204fddf4f616174259b7200c4eb5ffb24a40954f8585881d893d690a8113c2e8ceb450a9950559af5da100ad49f160696becdc148a1706184234d86a74849a6e0430b5582988970e70ac6b5a7d424b275827ae6a60bf783cc87a81bbabe9d9ca199b63) 8. Установите полученный в настройках бота Edna Chat Center токен в поле Edna Chat Center token. 9. ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-Ypj5LcEmpp/b1af744f1a751b00bf0e23120976499661877955fc82b5cabc197a99a8892468c120d13d6ac6a4f3a6ef2cf9caf73ab02756a28b1f62d71cac692cd447a51933e2b81f640c8e1b3b58e7c1ce1759098fde963c656f4984975f3a74ad96a0860e941da6a4) 10. Скопируйте URL из поля Chatbot webhook URL нажатием кнопки Copy this webhook и вставьте в поля URL бекенда чат-бота для обработки сообщений клиента и URL бекенда чат-бота для инициации диалога с клиентом в настройках бота в Edna Chat Center. 11. По необходимости переключите тумблер Receive service messages, чтобы получать Сервисные сообщения канала.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-_o9HpC8uZP/01e77cce8b84dc0e99e01bc7b447c4e8f284a08d1246b248ac1143884e3775fd35d958653bdd46f314280d8d69d6ba208f970b86c73004a7a01be38fecab4f5693a3b0219e9491c70caad1ac6d73b03015651e0e37ea7216c9c9249ff5ca8c8cd4c7f504) 12. Для сохранения Канал Проекта без его активации, нажмите кнопку CREATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-m91CluT_AG/003930dc4cef9f4597a9a2324d15a2d5ddd404b0757dc68a33ee0b68fc9a7e02e761034e7a49235d8eb458ca47329192eb6ba5cbd446747795698e8d33e863e629c93d25252aa56cf72fcbce24c61eeeb6d2568b8c054cfb9c6061fd1ecb2247ce7ea5b3) 13. Для сохранения и активации Канал Проекта, нажмите кнопку CREATE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-IlQUOHHYV5/41582c896ca0f661d4f3542939468b30629341d27a1a2e578f268fb8bfffbf8dba139eec6442be11b78c85d4fc56aac4bb663abdb9b6e063aa6f6b16eba6e8dd6c3d57e78688e9b2acbd5add86913109582def602ab5afecd97d8cf1702cadaed8e204ee) 14. 1. Канал Проекта будет сохранен и активирован, если: 2. 1. Агент обучен; 2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Канал Проекта будет сохранен, но не активирован, если одно или больше условий не будут выполнены. 15. Для отмены создания Канал Проекта нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-sr13X9Xy0w/91ac3288f5c99dca246da80b41c5658275ffc2bbb3556bc3b2da91114b47cd73a7457095c5cbfe61adaa6da091d0e7ff442eaa1dccc39230dbcd46665ab057f256922115afad1d3bd8ce1fcb15e9b163bbf95aabcd9887b4ad0a5939fed268472712ec31) ## Редактирование и удаление Канала Агента Для редактирования Канал Проекта, необходимо кликнуть по его иконке на карточке Агента.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-E2h-11QL6u/5e5f3561ffc5db5eb567120cb77fa8150d513c0ecbf3187b91885fc092fc495251c7c7901e241eac7a39ba73c3fa43eecc516c0285c5e771292efad6aa5b51260966ac99dcf9ae12520d58aca0c76ab8134c967cd6469cc3c07f73c056fe6a1e6d68fffd) 1. Чтобы отредактировать значение в любом поле, кликните по полю и впишите новое значение. 2. Чтобы применить изменения к активированному Канал Проекта, нажмите кнопку APPLY.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-AbiltlbfbC/2b6a1bc0de40c7a8320553f25443a35a7a8b6028a9bcf0354a0a254140a99aa66d5b81ed600e47b1855c57a218b53e0dc03cf23275cb3379651160e32a949c7b1e0ea40b17708ca1511a03536da6285ba9ae42b4d421bfd8a9e74aea81b80a277297dd98) 3. 1. Изменения будут применены, если: 2. 1. Агент обучен; 2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения не будут применены, если одно или больше условий не будут выполнены. 4. Чтобы деактивировать Канал Проекта, нажмите кнопку DEACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-zybYJ10TQG/3894ba4e726fd44ef476c9c75a3a856f7a9c31eb09d15be0d618a173cad9470b268108df6cef8cf9f08d4da1fb052d2352b5371e51d731c00abd7fbb1e9dc7435f2f280083181f0274bb199c43486d66e4da113ebd558d5166d5f06698dd628fbc7059ea) 5. Чтобы применить изменения к деактивированному Канал Проекта, нажмите кнопку SAVE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-LXgeKFNF2k/93e42aff93a5ef6198dfe0df4a0cdeacd44c01c7ca731dd3b728502997239345b0f6e278dc2d1c62a1491b3ca5c85a4d1a48d61f54765a0d6d7aa9fb07f0d8844d95c5c84405283d800eaa6d0923554aaadcb34602705241567014ea7d0154da4bc169c0) 6. Чтобы применить изменения и активировать Канал Проекта, нажмите кнопку SAVE & ACTIVATE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl-HazjHX9Nvh/af6de5c62a19f4913b4b32659e03e03feb2e3866b5204be100dd31c5b3410ede91d79454c8f8a7a166622e8f40850b51a58a6db34b3a2f8094dec226cb3ce9ed7396d7ffcbee7ce226eab0ede47ad89646b92482fe6554c04979f0c272463ae9c1ab5d45) 7. 1. Изменения будут применены и Канал Проекта будет активирован, если: 2. 1. Агент обучен; 2. токен в поле Edna Chat Center token уникален (нет ли активных Канал Проекта того же типа с тем же значением в поле); 3. будет доступен адрес Канал Проекта; 4. удастся зарегистрировать вебхук канала. 3. Изменения будут применены, но Канал Проекта не будет активирован, если одно или больше условий не будут выполнены. 8. Чтобы отменить внесение изменений, нажмите кнопку CANCEL.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--EML_sO9Sq/e26564fe1039969fd2c2b4ef2f6739d7a7a9c65b68e9234d74eb507ed3d335ad2ede749491a2bcd2c28df137ccfcbf01f0af471c1dd842654fd42f852aa05344bb3f677517053cfc24c194255f06106cee0cd38063e65ab7a6ce98bd8955290557028db1) 9. Чтобы удалить Канал Проекта, нажмите кнопку DELETE.\ ![image.png](https://codahosted.io/docs/_pM7PjYCmj/blobs/bl--8vixBcUOZ/4336e02dece54524bce79324d57a1fc36db6607ec63bd1680cd127202d9fe34f9154f3d181b3593b78df77155b2c7293625c30742d25075ea3db20ca7284839741cd755205fbab0e92e0b039d3168f599e5dc5a3c1b89561f17342bb8d0ca35c5c0ea619) ## Общение Взаимодействие с Edna происходит через [Edna external API](https://fdd.edna.ru/f/0ec5a3307e8c47cd9b8c/) и согласно настройкам вашего аккаунта Edna. Агент является ботом-оператором в Edna. > Важно: Edna не может гарантировать порядок доставки сообщений до Собеседника: если интервал их поступления от Агента очень маленький, чтобы устранить данное негативное поведение, на Коннекторе к Edna введена задержка в 0,5 секунд между отправкой сообщений. | Переменная | Конечный канал | Переменная в запросе из канала | | --------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | | channel\_visitor\_id | Edna Chat Center | threadsClientId | | channel\_conversation\_id | Edna Chat Center | sessionId | | channel\_visitor\_firstname | Edna Chat Center | client\_data.name | | channel\_visitor\_lastname | Edna Chat Center | Нет | | channel\_visitor\_phone | Edna Chat Center | client\_data.phoneПосле отправки рассылки Слотом Notification в эту переменную попадает номер телефона, на который была отправлена рассылка | | channel\_visitor\_email | Edna Chat Center | client\_data.email | | channel\_visitor\_account | Edna Chat Center | channel\_info.channelType | | channel\_visitor\_auth | Edna Chat Center | Нет | | channel\_visitor\_source | Edna Chat Center | Нет | | Функционал общения | Конечный канал | Доступность в канале | Примечания | | --------------------------------------------------------------- | ---------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Кнопки | Edna Chat Center | Да |

Максимальная длина текста кнопки — 20 символов. При превышении длины в 20 символов происходит зависание Сценария. Увеличить лимит можно через техподдержку Edna.

При работе Агента в Viber кнопки не отображаются и общение переводится на оператора

| | Перевод на оператора | Edna Chat Center | Да | Для перевода диалога на оператора используется слот Change Chat Mode.Также возможен перевод на оператора через [метод API.](https://fdd.edna.ru/f/0ec5a3307e8c47cd9b8c/)по External Request | | Передача файлов в виде файлов от Агента (Attachment) | Edna Chat Center | Нет | | | Передача файлов в виде ссылок от Агента (Attachment) | Edna Chat Center | Да | | | Получение файла от Собеседника в сценарий | Edna Chat Center | Частично | Зависит от канала, виджет Edna не принимает файлы. Метаданные файла (тип, ссылка) записываются в client\_message, файл в платформу не закачивается | | Получение геолокации от собеседника в сценарии | Edna Chat Center | Нет | | | Доставка сообщений более 1000 символов от Агента до Собеседника | Edna Chat Center | Да | Доставка сообщений до 4000 символов | | Использование маркдауна | Edna Chat Center | Частично | Поддерживается в виджете. Отображение текста, размеченного с помощью Markdown, в остальных каналах не поддерживается.Поддерживаются следующие типы разметки:\*курсив\*\_курсив\_\_\_жирный шрифт\_\_\*\_\_жирный курсив\_\_\*\[ссылка]\( код\` | | Рассылки с помощью Notification | Edna Chat Center | Нет | | | Сообщение | Конечный канал | Client message | Описание | Примечания | | --------------------------------- | ---------------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | | Открытие виджета Edna Chat Center | Edna Chat Center | Строка: edna: chat initialized | При открытии виджета Edna на веб-странице в переменную client\_message пробрасывается сообщение ‘edna: chat initialized’. | Бот может реагировать на открытие виджета на веб-странице приветственным сообщением | \ О том, что такое сервисные сообщения и как активировать их передачу из Конечный канал: Принцип вывода Агента в различные каналы