У цій статті ми розкажемо, як використовувати вхідний вебхук для створення ліда або контакта за допомогою PHP та Python

Спочатку створіть новий вхідний вебхук. Для створення вебхука скористайтеся статтею 

Основні принципи його використання описані в тій самій статті. Щоб використовувати вебхук для доступа до сутностей CRM необхідно задати URL, за яким ми будемо відправляти запити. Для Лідів це

https://domain.uspacy.ua/company/v1/incoming_webhooks/run/WEBHOOK_CODE/crm/v1/entities/leads

Для Контактів він буде виглядати як 

https://domain.uspacy.ua/company/v1/incoming_webhooks/run/WEBHOOK_CODE/crm/v1/entities/contacts

По суті, ми змінюємо лише сутність після entities. Якщо ми не знаємо, як називаються поля, котрі ми хочемо заповнити в ліді або контакті, ми можемо подивитися доступні поля або на вашому просторі в розділі 

Налаштування - Розділи - CRM - Ліди

), або за допомогою невеликого скрипта: 

<?php

$fieldsUrl = "https://domain.uspacy.ua/company/v1/incoming_webhooks/run/WEBHOOK_CODE/crm/v1/entities/contacts/fields";

$ch = curl_init($fieldsUrl);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
]);
$fieldsResponse = curl_exec($ch);
$fieldsHttpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "=== Lead Fields (HTTP $fieldsHttpCode) ===\n";
echo json_encode(json_decode($fieldsResponse, true), JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE) . "\n\n";


Маючи коди полів, котрі нам необхідні, можемо використовувати їх для створення ліда:


<?php

// --- Create lead via webhook ---
$webhookUrl = 'https://domain.uspacy.ua/company/v1/incoming_webhooks/run/WEBHOOK_CODE/crm/v1/entities/leads';

$data = [
        'title' => 'Test Lead from Webhook',
        'utm_source' => 'test',
        'utm_medium' => 'webhook',
        'utm_campaign' => 'test_campaign',
        'utm_content' => 'test_content',
        "email" => [
            [
            "type" => "WORK",
            "value" => "test@gmail.com"
            ]
        ],
        "phone" => [
            [
            "type" => "WORK",
            "value" => "+380980000001"
            ]
        ]
];

$ch = curl_init($webhookUrl);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($data),
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$error = curl_error($ch);
curl_close($ch);

if ($error) {
    echo "cURL Error: $error\n";
    exit(1);
}

echo "HTTP Code: $httpCode\n";
echo "Response: $response\n";


import json
import requests

# --- Create lead via webhook ---
webhook_url = "https://domain.uspacy.ua/company/v1/incoming_webhooks/run/WEBHOOK_CODE/crm/v1/entities/leads"

data = {
    "title": "Test Lead from Webhook",
    "utm_source": "test",
    "utm_medium": "webhook",
    "utm_campaign": "test_campaign",
    "utm_content": "test_content",
    "email": [
        {"type": "WORK", "value": "test@gmail.com"}
    ],
    "phone": [
        {"type": "WORK", "value": "+380980000001"}
    ],
}

response = requests.post(webhook_url, json=data)

print(f"HTTP Code: {response.status_code}")
print(f"Response: {response.text}")


Документація та підказки для створення власних застосунків і інтеграцій з Uspacy — від перших кроків розробки до запуску готових рішень у Просторі.

Вебхуки. Приклад створення ліда