Почтовый вебхук
Как письма в почтовый ящик агента попадают в Veyra через AgentMail, как каждая доставка проверяется подписями Svix и как ответы собираются в цепочки.
У агента может быть свой почтовый адрес. Письма на этот адрес приходят через сервис AgentMail, который доставляет их в Veyra по адресу:
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.