Zoho Bigin

Интеграция Zoho Bigin API с поддержкой управляемой OAuth-аутентификации. Позволяет работать с контактами, компаниями, воронками продаж и продуктами внутри CRM Bigin.

Используйте этот инструмент, когда необходимо создавать, читать, обновлять или удалять записи CRM, искать контакты или управлять пайплайнами продаж. Для работы с другими сторонними сервисами рекомендуется использовать отдельный инструмент API Gateway.

Требуется доступ к сети и действительный API-ключ Maton.

Zoho Bigin

Получите доступ к API Zoho Bigin через управляемую OAuth-аутентификацию. Управляйте контактами, компаниями, воронками и продуктами с полной поддержкой CRUD-операций (создание, чтение, обновление, удаление).

Быстрый старт

# Получение списка контактов
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/zoho-bigin/bigin/v2/Contacts?fields=First_Name,Last_Name,Email')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/zoho-bigin/bigin/v2/{endpoint}

Шлюз проксирует запросы к www.zohoapis.com/bigin/v2 и автоматически добавляет OAuth-токен.

Аутентификация

Все запросы требуют API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Войдите или зарегистрируйтесь на maton.ai
• Перейдите в настройки аккаунта
• Скопируйте ваш API-ключ

Управление подключениями

Управление OAuth-подключениями Zoho Bigin осуществляется через сервис:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=zoho-bigin&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'zoho-bigin'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Получение подключения

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

{
 "connection": {
 "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
 "status": "ACTIVE",
 "creation_time": "2025-12-08T07:20:53.488460Z",
 "last_updated_time": "2026-01-31T20:03:32.593153Z",
 "url": "https://connect.maton.ai/?session_token=...",
 "app": "zoho-bigin",
 "metadata": {}
 }
}

Откройте полученный URL в браузере, чтобы завершить OAuth-авторизацию.