Відправка інформації з угод

Зміст

Загальна інформація

Створення Webhook

Додаткова інформація

Загальна інформація

За допомогою вихідного Webhook, KeepinCRM може автоматично відправляти інформацію при будь-яких діях з угодою. Наприклад:

• При створенні - відправити інформацію в іншу систему
• При переході на етап - відправити інформацію в іншу систему
• При завершенні замовлення (результат Виграно) - відправити інформацію в іншу систему
• При зміні відповідального і тому подібне

Створення Webhook

Щоб налаштувати відправку потрібно створити тригер як на фото, вказавши URL на який відправляти та потрібні змінні в Body

• Таблиця з даними - Угоди
• Дія - Webhook
• URL - URL на який відправляти інформацію
• Метод відправки - POST (або інший)
• Успішний статус запиту - 200
• Content-Type - application/json (або інші)
• Тіло запиту (Body) - Наприклад:

{
  "name": "{{client.person}}",
  "email": "{{client.email}}",
  "phone": "{{client.phone}}",
  "stage_id": "{{stage.name}}",
  "dealtitle": "{{title}}",
  "source": "{{source_id}}",
  "ttn": "{{last_ttn}}",
  "utm_source": "{{custom_fields.utm_source_217517}}",
  "utm_campaign": "{{custom_fields.utm_campaign_213340}}",
  "utm_content": "{{custom_fields.utm_content_2283411}}",
  "utm_medium": "{{custom_fields.utm_medium_22833410}}",
  "responsible": "{{main_responsible_id}}",
  "responsible_name": "{{main_responsible.name}}"
}

• Умова виконання - вказується необхідна
  • created_at - при створенні угоди
  • stage.name == 'Відправлено' - при переході на етап відправлено
  • result == 'successful' - при успішному результаті угоди (Виграно)
  • та інші

Важливо!

1. В Body вказуються чіткі назви змінних з налаштувань полів
2. Якщо потрібні поля з картки клієнта і таблиця Угоди, то додається приставка client. Якщо обрана таблиця контрагенти, то цю приставку не треба
3. Якщо потрібні дані з користувацьких полів, то обов'язково додається приставка custom_fields.

Приклад налаштованого тригера:

Щоб в угоду додати відправку інформації про товари, додається такий формат:

{{#jobs}}
{
  "amount": {{amount}},
  "title": "{{title}}",
  "product_attributes":
   {
    "sku": "{{sku}}",
    "title": "{{title}}",
    "price": "{{price}}"
   }
}
{{^_last}},{{/_last}}
{{/jobs}}

Якщо потрібно відправити тільки назви товарів через кому, то використовується такий формат:

{{#jobs}}{{product.title}}{{^_last}}, {{/_last}}{{/jobs}}

Якщо потрібно відправити тільки статус ТТН (всіх, які додані в угоду) через кому, то використовується такий формат:

{{#deliveries}}{{status_description}}{{^_last}}, {{/_last}}{{/deliveries}}

Додаткова інформація

• Доступно на розширеному тарифі
• Працює для угод, контрагентів, завдань
• На фото тільки приклад можливих відправлень, сам Body коригується згідно з форматом системи, яка отримує ці дані
• Якщо потрібно передати Voip номер з профілю користувача KeepinCRM, то використовується змінна: {{user.voip_number}}
• Якщо потрібно передати з угоди email користувача KeepinCRM, то використовується змінна: {{main_responsible.email}}