Каналы для агентов и интеграций
Все каналы пишут в одну базу заявок. Ни один канал не подтверждает встречу автоматически: подтверждает только Анатолий Титов (в кабинете или по подписанной ссылке из письма), либо заявитель выбирает одно из времён, которые Анатолий сам предложил.
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-параметрах ссылки на форму.