# Письма CRM

Чтение и отправка писем дел CRM. Это отдельный API от [модуля почты](/docs/mail).

Битрикс24 API: `crm.activity.mail.*, crm.{deal,lead,contact,company}.timeline.activity.email.*`
Скоуп: `crm`

На портале без соответствующего метода возвращается `422 METHOD_NOT_YET_AVAILABLE`, `error.release` — `crm 26.800.1`.

## Операции

- [Список писем CRM](./crm-emails/list.md) — `GET /v1/deals/:id/emails`
- [Отправить письмо из CRM](./crm-emails/send.md) — `POST /v1/deals/:id/emails`
- [Получить содержимое письма CRM](./crm-emails/get.md) — `GET /v1/crm-emails/:activityId`
- [Получить цепочку писем CRM](./crm-emails/thread.md) — `GET /v1/crm-emails/:activityId/thread`
- [Ответить на письмо CRM](./crm-emails/reply.md) — `POST /v1/crm-emails/:activityId/reply`

## Ключевые поля

| Поле | Описание |
|---|---|
| `id` | Идентификатор. |
| `subject` | Тема письма. |
| `body` | Текст письма без HTML. |
| `isHidden` | Сообщение скрыто. Тогда доступны только `id:0`, `cc:null`, `bcc:null`, `isHidden:true`. |
| `warnings` | Предупреждения об отправке и синхронизации. |

## Что нужно знать перед работой

Чтение доступно ключам READONLY. Отправка и ответ отправляют настоящее письмо и требуют READWRITE. Не повторяйте неоднозначную отправку вслепую.

## Типичный сценарий

1. Найдите запись CRM.
2. Прочитайте список писем.
3. Получите содержимое и цепочку по идентификатору дела.
4. После отправки проверьте список перед повтором.

## Лимиты

Список писем читает одну страницу с `limit` и `offset`. Усечение текста и цепочки отражают `isBodyTruncated` и `isTruncated`.

## Смотрите также

- [Модуль почты](/docs/mail)
- [Ошибки](/docs/errors)