В статье рассказываем, как внедрить окно чатов Wazzup в свою CRM и настроить работу раскрывающегося списка «Сделки» по событиям.

Мы рекомендуем работать со списком «Сделки» с помощью вебхуков. А если вебхуки не подходят — по событиям.

Как внедрить окно чатов Wazzup в свою CRM

Чтобы получить ссылку, по которой откроется окно чатов, необходимо вызвать:

POST /v3/iframe
├── user *
│   ├── id *
│   └── name
├── scope *
├── filter[]
│   ├── chatType
│   ├── chatId
│   └── name
├── activeChat
│   ├── channelId
│   ├── chatType
│   └── chatId
└── options
    ├── clientType
    ├── useDealsEvents
    └── useMessageEvents

Параметры запроса

user (объект)

filter (объект)

activeChat (объект)

options (объект)

Если контакта с указанными chatType и chatId нет в базе данных Wazzup — при открытии его в карточке контакта CRM-системы он будет создан. В качестве имени будет использовано значение name или chatId, если первое отсутствует.

Пример запроса

curl --location --request POST 'https://api.wazzup24.com/v3/iframe' \
--header 'Authorization: Bearer c8cf90554027882f912520f454468d27' \
--header 'Content-Type: application/json' \
--data-raw '
{
"user": {
"id": "222555",
"name": "User Name"
},
"scope": "card",
"filter": [
{
"chatType": "whatsapp",
"chatId": "79998887766"
}
],
"activeChat": {
"chatType": "whatsapp",
"chatId": "79998887766"
}
}
'

Ответ

В ответе придет json со ссылкой для открытия окна чатов.

Если открываете ссылку в iFrame, добавьте в тег атрибут allow="microphone *; clipboard-write *".

Указать "microphone" нужно, чтобы из окна с чатами можно было записывать голосовые сообщения. Если этого не сделать, пользователь увидит ошибку при нажатии на значок микрофона для записи.

Передавать "clipboard-write" необходимо, чтобы в нашем iFrame правильно работало копирование в буфер обмена. Например, пользователь мог по кнопке скопировать код ошибки из уведомления.

<iframe src="ссылка" allow="microphone *; clipboard-write *" ></iframe>

Пример ответа

{
"url": "https://12345678.wazzup24.com/chat/0e812899-e25b-4a18-a3e4-d1f5890f9de7?token=${token}"
}

В случае ошибки в ответе поступит json, который содержит свойство error или http-код 500.

Пример ответа с ошибкой

{ "error": { "code": "NO_SUCH_ACCOUNT" } }

Как настроить работу со списком «Сделки» по событиям

События сигнализируют о том, что нужно:

• создать новую сделку,
• показать сущность, которую пользователь хочет открыть,
• создать новый контакт.

{
  type: 'WZ_CREATE_ENTITY',
  data: {
    chatType: whatsapp,
    chatId: 79998887766,
    channelId: c16tc1c-9f20-4rda-46jd-q92ty4j6s36888,
    userId: test_id,
    integrationId: 608df5ye-45hj-j6k7-l77k-qe5t88j4h1222
  }

{
  type: 'WZ_OPEN_ENTITY',
  data: {
    chatType: whatsapp,
    chatId: 79998887766,
    channelId: c16tc1c-9f20-4rda-46jd-q92ty4j6s36888,
    userId: test_id,
    integrationId: 608df5ye-45hj-j6k7-l77k-qe5t88j4h1222,
    entity: {
      closed: false,
      id: clientId3,
      link: #,
      name: ТестоваяСделка,
      responsibleUserName: ТестовыйПользователь
    }
  }
}

*Запрещены и признаны экстремистскими на территории РФ