연락처

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>로 resolve되므로 행은 page.items에 있고, page.hasMore가 true인 동안 page.nextCursor를 따라갑니다. get, create, update는 각각 같은 행에 audiences가 더해진 ContactDetailResource 하나로 resolve됩니다. 주소록에는 상한이 없으며, 그래서 이 경로는 조용히 200행에서 멈추는 배열 대신 페이징을 합니다.