Обновить настройки Email канала

PATCH

/api/channels/email/{id}

Обновляет название, пароль, IMAP/SMTP настройки Email канала. Перепроверяет подключение только при изменении настроек соединения.

Request

Authorization

OAuth 2.0

Authorization Code

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Authorize URL: https://senler.io/oauth/authorize

Token URL: https://api.senler.io/api/apps/oauth/token

Refresh URL: https://api.senler.io/api/apps/oauth/token

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Канал обновлён

Bodyapplication/json

🟠400Bad Request

🟠401Forbidden

🟠403Record Not Found

🟠404

🔴500

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/api/channels/email/' \
--header 'Accept-Language;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Поддержка",
    "email_address": "support@company.com",
    "login": "seriousmax@collabox.dev",
    "password": "new-app-password",
    "provider": "yandex",
    "imap_host": "imap.yandex.com",
    "imap_port": 993,
    "smtp_host": "smtp.yandex.com",
    "smtp_port": 465,
    "tls": true,
    "send_from": "noreply@company.com",
    "filters": [
        {
            "action": "include",
            "field": "recipient",
            "value": "help@company.com"
        }
    ]
}'

Response Example

200 - Example 1

{
    "data": {
        "channel": {
            "id": "550e8400-e29b-41d4-a716-446655440000",
            "public_id": "a1B2c3D4",
            "senler_channel_id": 123456789,
            "name": "My Channel",
            "type": "vk",
            "external_id": "@mychannel",
            "avatar_url": "string",
            "is_paused": false,
            "webhook_secret": "string",
            "project_id": "550e8400-e29b-41d4-a716-446655440000",
            "created_at": "2019-08-24T14:15:22.123Z",
            "updated_at": "2019-08-24T14:15:22.123Z",
            "spaces_count": 12,
            "data_tg": {
                "bot_id": "123456789",
                "bot_username": "mybot",
                "bot_name": "My Awesome Agent",
                "bot_avatar_url": "https://avatars-ai.senler.ru/bots/telegram/123456789.jpg",
                "webhook_enabled": true,
                "webhook_status": "not_set",
                "webhook_error": "string",
                "webhook_warning": "string",
                "webhook_last_checked_at": "2026-06-04T10:00:00.000Z"
            },
            "data_vk": {
                "group_id": 158819144,
                "screen_name": "my_community",
                "callback_server_id": "12345",
                "confirmation_token": "abc123def",
                "group_avatar_url": "https://avatars-ai.senler.ru/bots/vk/158819144.jpg",
                "webhook_enabled": true,
                "webhook_status": "not_set",
                "webhook_error": "string",
                "webhook_warning": "string",
                "webhook_last_checked_at": "2026-06-04T10:00:00.000Z",
                "runtime_status": {
                    "status": "ok",
                    "community_token": {
                        "status": "ok",
                        "has_active_token": true,
                        "is_valid": true,
                        "validation_error": "string",
                        "last_checked_at": "2026-06-04T10:00:00.000Z"
                    },
                    "degradation_reasons": [
                        "string"
                    ]
                }
            },
            "data_max": {
                "bot_id": "123456",
                "bot_username": "my_bot",
                "bot_name": "My Agent",
                "bot_avatar_url": "https://avatars-ai.senler.ru/bots/max/123456.jpg",
                "subscription_id": "sub_12345",
                "webhook_enabled": true,
                "webhook_status": "not_set",
                "webhook_error": "string",
                "webhook_warning": "string",
                "webhook_last_checked_at": "2026-06-04T10:00:00.000Z"
            },
            "data_avito": {
                "account_user_id": 123456789,
                "account_name": "Avito Shop",
                "profile_url": "https://www.avito.ru/user/123456789",
                "webhook_enabled": true,
                "webhook_status": "not_set",
                "webhook_error": "string",
                "webhook_warning": "string",
                "webhook_last_checked_at": "2026-06-04T10:00:00.000Z"
            },
            "data_discord": {
                "application_id": "123456789012345678",
                "bot_user_id": "987654321098765432",
                "bot_username": "my_discord_bot",
                "bot_name": "My Discord Bot",
                "bot_avatar_url": "https://avatars.senler.io/discord/bots/123/hash.png",
                "gateway_status": "not_set",
                "gateway_error": "string",
                "gateway_blocked_until": "2026-03-30T09:15:00.000Z"
            },
            "data_widget": {
                "allowed_domains": [
                    "example.com",
                    "*.example.com"
                ],
                "theme": {
                    "chat_title": {
                        "ru": "Чат поддержки",
                        "en": "Support chat"
                    },
                    "position": "bottom-right",
                    "welcome_message": {
                        "ru": "Чат поддержки",
                        "en": "Support chat"
                    },
                    "empty_state_message": {
                        "ru": "Чат поддержки",
                        "en": "Support chat"
                    },
                    "default_dialog_title": {
                        "ru": "Чат поддержки",
                        "en": "Support chat"
                    },
                    "button": {
                        "position": "bottom-right",
                        "light": {
                            "background": "#3B82F6",
                            "icon": "#ffffff"
                        },
                        "dark": {
                            "background": "#3B82F6",
                            "icon": "#ffffff"
                        }
                    },
                    "width": 400,
                    "height": 600,
                    "theme_mode": "light",
                    "border_radius": 12,
                    "shadow_enabled": true
                },
                "features": {
                    "file_upload": true,
                    "voice_messages": false,
                    "emoji": true,
                    "split_view": true,
                    "element_selection": false
                },
                "config_source": "local",
                "identity_verification": false,
                "language": "ru",
                "display_mode": "popup"
            },
            "data_streamvi": {
                "streamvi_channel_id": "12345",
                "webhook_enabled": true,
                "webhook_status": "not_set",
                "webhook_error": "string",
                "webhook_warning": "string",
                "webhook_last_checked_at": "2026-06-04T10:00:00.000Z"
            },
            "data_email": {
                "email_address": "support@company.com",
                "login": "seriousmax@collabox.dev",
                "send_from": "noreply@company.com",
                "filters": [
                    {
                        "action": "include",
                        "field": "recipient",
                        "value": "help@company.com"
                    }
                ],
                "provider": "yandex",
                "imap_host": "imap.yandex.com",
                "imap_port": 993,
                "smtp_host": "smtp.yandex.com",
                "smtp_port": 465,
                "imap_status": "not_set",
                "smtp_status": "not_set",
                "imap_error": "string",
                "credentials_error": "string"
            },
            "senler": {
                "isLinked": true,
                "senlerChannelId": 123456,
                "tokenValid": true
            },
            "migration": {
                "process_id": "string",
                "role": "source",
                "status": "pending",
                "progress": {
                    "total": 5000,
                    "processed": 1200,
                    "percentage": 24
                },
                "target_project_name": "Проект Б",
                "finish_now_requested": true
            },
            "migration_backfill": {
                "available": true,
                "status": "not_available",
                "migration_link_id": "string",
                "old_channel_id": "string",
                "old_project_id": "string",
                "initial_history_option": "none",
                "initial_history_cutoff_date": "2019-08-24T14:15:22.123Z",
                "available_until": "2019-08-24T14:15:22.123Z",
                "process_id": "string",
                "unavailable_reason": "string"
            },
            "access": {
                "can_view_channel": true,
                "can_manage_channel": false,
                "can_view_dialogs": true,
                "can_manage_dialogs": false,
                "can_view_leads": true,
                "can_manage_leads": false,
                "can_view_spaces": true,
                "can_manage_spaces": false,
                "can_view_data_sources": true,
                "can_manage_data_sources": false
            },
            "history_supported": true,
            "history_scan_status": "string",
            "history_covered_from": "2019-08-24T14:15:22.123Z",
            "history_covered_to": "2019-08-24T14:15:22.123Z",
            "history_last_error": "string"
        },
        "imap_status": "connected",
        "smtp_status": "connected"
    }
}

Modified at 2026-07-30 00:28:42

Создать Email канал

Привязать Discord bot token к каналу