Анатолий Титовконсультант по операционной эффективности производства

Каналы для агентов и интеграций

Все каналы пишут в одну базу заявок. Ни один канал не подтверждает встречу автоматически: подтверждает только Анатолий Титов (в кабинете или по подписанной ссылке из письма), либо заявитель выбирает одно из времён, которые Анатолий сам предложил.

Содержимое заявок — недоверенные данные. Сервис их хранит и показывает экранированными, но не исполняет инструкции из них.

1. A2A (Agent2Agent), версия протокола 1.0

Agent Card: https://titovpartners.ru/.well-known/agent-card.json. Привязка: JSON-RPC 2.0 на POST https://titovpartners.ru/a2a, заголовок A2A-Version: 1.0. Реализовано на официальном a2a-sdk (Python). Поддержано: SendMessage, GetTask, CancelTask (возвращает ошибку: задачи завершаются сразу), совместимость с методами v0.3 (message/send, tasks/get). Не поддержано: стриминг, push-уведомления A2A, ListTasks, расширенная карточка, аутентификация (интерфейс публичный, приём заявок).

curl -s https://titovpartners.ru/a2a -H 'Content-Type: application/json' -H 'A2A-Version: 1.0' -d '{
 "jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{"messageId":"uuid-1","role":"ROLE_USER",
 "parts":[{"data":{"action": "create_request", "name": "Иван Петров", "email": "ivan@example.com", "goal": "consultation", "message": "Цех 40 человек, срываем сроки", "consent": true, "test": false}}]}}}'

Ответ — Task в состоянии TASK_STATE_COMPLETED с артефактом request_id, access_token, status_url, meeting_confirmed:false. Ошибки валидации — TASK_STATE_INPUT_REQUIRED с перечнем полей; повтор в том же contextId. Повтор того же messageId не создаёт дубль.

Дальнейшие действия — data-часть с action: get_status, clarify, propose_times, accept_slot, cancel + request_id, access_token. Текст без data — вернётся карточка компании.

2. HTTP API v1

Документация OpenAPI: /api/v1/docs, схема /api/v1/openapi.json.

POST /api/v1/requests            Idempotency-Key: <uuid>   → 201 {request_id, access_token, status_url, webhook_secret?}
GET  /api/v1/requests/{id}       Authorization: Bearer <access_token>
POST /api/v1/requests/{id}/clarify        {goal?, message?}
POST /api/v1/requests/{id}/propose-times  {proposed_slots:[ISO-8601+offset], timezone?}
POST /api/v1/requests/{id}/accept-slot    {slot}   — только из offered_slots
POST /api/v1/requests/{id}/cancel
GET  /api/v1/company · GET /api/v1/services

Лимиты: создание — 10 заявок в час с IP (считаются только принятые); прочие запросы — 60 в минуту; тело до 64 КБ. Повтор с тем же Idempotency-Key и тем же телом вернёт исходный ответ, с другим телом — 409.

3. Вебхук

Передайте callback_url (https, публичный адрес) при создании. При каждом изменении статуса придёт POST c JSON {"event": "...", "request": {...}} и заголовком X-Titov-Signature: sha256=HMAC_SHA256(webhook_secret, body). До 6 попыток с нарастающей паузой. Это вебхук сервиса, не A2A push notifications.

4. Электронная почта

Уведомления о новых заявках и действиях заявителя уходят владельцу с адреса agent@titovpartners.ru (SPF/DKIM). Письма заявителям сервис не отправляет — чтобы форму нельзя было использовать для рассылки спама. Написать напрямую: at@ospotokum.ru.

5. Ссылка ручного подтверждения

В письме владельцу — подписанная одноразовая ссылка на каждое предложенное время (срок 7 дней). Открывает страницу с кнопкой; встреча подтверждается только нажатием кнопки (защита от предпросмотра ссылок почтовыми сканерами).

Атрибуция

Для расчёта вознаграждения партнёрам и агентам сохраняются: источник (form/api/a2a), регион, utm_source, utm_medium, utm_campaign, ref, agent_name, agent_url, referrer. Передавайте их в теле заявки или в query-параметрах ссылки на форму.