Контакты

const page = await openemail.contacts.list({ limit: 100 })  const contact = await openemail.contacts.get('[email protected]')   const saved = await openemail.contacts.create({    email: '[email protected]',    name: 'Grace Hopper',    notes: 'Met at the compiler workshop',  })   await openemail.contacts.update(saved.email, { notes: null })  await openemail.contacts.delete(saved.email)   console.log(page.items.length, page.hasMore, contact.source, contact.lastSeenAt)

Сначала те, кого видели недавно, а контакты, которым никогда не писали, — в конце. source равен auto, когда строка появилась потому, что участник отправил на этот адрес сообщение из редактора приложения, а это существенно иное утверждение, нежели то, что кто-то его сохранил. Почта, приходящая с адреса, ничего не записывает, и отправка через этот API тоже.

Книга принадлежит рабочему пространству, а не одному человеку, так что контакт, сохранённый любым участником, — это контакт, который видят все участники и все ключи. create записывает source как manual и помещает контакт в аудиторию по умолчанию прямо при записи. Назовите свои списки в audienceIds, чтобы добавить его в них тем же вызовом, — для этого нужна ещё и audiences:write, — либо добавьте контакт позже через openemail.audiences.addContact.

contacts.list разрешается в Page<ContactResource>, так что строки лежат в page.items, а обход идёт по page.nextCursor, пока page.hasMore истинно. get, create и update разрешаются каждый в один ContactDetailResource — ту же строку плюс audiences. Адресная книга не ограничена по размеру, поэтому этот маршрут постраничный, а не возвращающий массив, который молча обрывался на 200.