Почтовый вебхук

Как письма в почтовый ящик агента попадают в Veyra через AgentMail, как каждая доставка проверяется подписями Svix и как ответы собираются в цепочки.

Veyra Docs TeamОбновлено 1 мин чтенияВерсия 2 · История

У агента может быть свой почтовый адрес. Письма на этот адрес приходят через сервис AgentMail, который доставляет их в Veyra по адресу:

HTTP
POST https://intelligence-api.veyra.so/api/chat-webhooks/agentmail/{publicId}

Проверка

AgentMail подписывает каждую доставку через Svix. Прежде чем что-либо читать, Veyra сверяет заголовки svix-id, svix-timestamp и svix-signature с секретом подписи ящика по исходному телу. Доставка без действительной подписи отклоняется.

Ответы

Код Значение
204 Принято.
403 Тело доставлено не в исходных байтах, или проверка подписи не прошла.
Другие 4xx Ящик не существует, приостановлен или отключён.

Сервис повторяет неудачные доставки; svix-id не даёт повтору создать второе сообщение.

Что происходит с письмом

  • Новое письмо создаёт задачу для агента этого ящика.
  • Ответ в цепочке, где участвует агент, продолжает эту задачу.
  • Вложения сохраняются вместе с задачей после обычных проверок файлов.

Исходящая почта агента всегда относится к задаче. Ответ привязан к сообщению, на которое отвечает, и не может менять получателей или тему. Отправка в очереди ещё не доставлена; статус доставки показывает, когда сервис её принял.

Настройка

Подключите почту в Connectors как канал чата. При настройке вебхук регистрируется в AgentMail автоматически.

См. раздел Почта в справочнике API.

ВебхукиВходящиеПочта