Встраивание PACT Embed с помощью iframe

Формирование ссылки iframe

• company_uuid (пример: 90cbceee-2d3a-4dfd-b021-489ead21b830): идентификатор компании. Его можно получить запросом к PACT API (создание или получение списка компаний). Пример запроса для списка компаний:
  GET https://api.pact.im/p1/companies
  Из ответа необходимо использовать external_uuid:
• signature: Сигнатура для аутентификации, генерируется с помощью SHA512.
  • Ruby:
    

    require 'openssl'
    private_api_token = 'your_private_api_token'
    company_uuid = 'YOUR_COMPANY_UUID'
    hash = OpenSSL::HMAC.hexdigest(
        'SHA512',  
        private_api_token,  
        company_uuid)
    puts hash
                    
  • JavaScript:
    

    const crypto = require('crypto');
    const privateApiToken = 'your_private_api_token';
    const companyUuid = 'YOUR_COMPANY_UUID';
    const hmac = crypto.createHmac('sha512', privateApiToken);
    hmac.update(companyUuid);
    const hash = hmac.digest('hex');
    console.log(hash);
                    
  • Python:
    

    import hmac
    import hashlib
    private_api_token = 'your_private_api_token'
    company_uuid = 'YOUR_COMPANY_UUID'
    hash = hmac.new(
        private_api_token.encode(),    
        company_uuid.encode(),    
        hashlib.sha512
    ).hexdigest()
    print(hash)
    

  • PHP:
    

    <?php
    $privateApiToken = 'your_private_api_token';
    $companyUuid = 'YOUR_COMPANY_UUID';
    $hash = hash_hmac('sha512', $companyUuid, $privateApiToken);
    echo $hash;
    ?>
    

• Сигнатура будет зашифрованным ключом (частный API токен) и UUID компании. Пример готовой ссылки с обязательными параметрами:
  

  https://msg.pact.im/pact_embed?company_uuid=1234a567-2d3a-4dfd-b021-489ead21b830&signature=d41d8cd98f00b204e9800998ecf8427e

Дополнительные параметры

• scope: Указывает область взаимодействия. Так, scope=messages будет включать только отображение конкретной переписки, а scope=conversations будет открывать список переписок в переданной компании.
  Если не передан параметр scope, будет использоваться scope=conversations.
  Если не передан параметр scope, но передан phone, то будет попытка использовать scope=messages.
• conversation_id: Позволяет открыть конкретный диалог по его ID при использовании scope=messages. Пример: conversation_id=12345. Обязателен при scope=messages и если не передан phone и provider.
• phone: Номер телефона для автоматического поиска пользователя. Пример: phone=+1234567890. Обязателен при scope=messages.
• provider: Указывает провайдера связи, если применимо. Пример: provider=whatsapp, provider=whatsapp_business, и т. д.

Полный пример ссылки с дополнительными параметрами:

Для загрузки списка чатов:

https://msg.pact.im/pact_embed?company_uuid=1234a567-2d3a-4dfd-b021-489ead21b830&signature=d41d8cd98f00b204e9800998ecf8427e&scope=conversations

Для загрузки диалога по его ID:

https://msg.pact.im/pact_embed?company_uuid=1234a567-2d3a-4dfd-b021-489ead21b830&signature=d41d8cd98f00b204e9800998ecf8427e&scope=messages&conversation_id=12345