Kontaktet

$page = $client->contacts->list(limit: 100);$contact = $client->contacts->get('[email protected]'); $saved = $client->contacts->create([    'email' => '[email protected]',    'name' => 'Grace Hopper',    'notes' => 'Met at the compiler workshop',]); $client->contacts->update('[email protected]', ['notes' => null]);$client->contacts->setAudiences('[email protected]', ['audienceIds' => ['aud_4c1b8e2a7d9f05c36b4e8a71']]);$client->contacts->delete('[email protected]'); echo count($page), ' ', $page->hasMore ? 'more to come' : 'that is all', PHP_EOL;echo $contact['source'], ' ', $contact['lastSeenAt'] ?? 'never mailed', ' ', $saved['source'], PHP_EOL;

list kthen së pari kontaktet e para më së fundi, dhe në fund kontaktet të cilave nuk u është dërguar kurrë postë. source është auto kur rreshti u shkrua sepse një anëtar i dërgoi asaj adrese një mesazh nga kompozuesi i aplikacionit, që është një pohim thelbësisht i ndryshëm nga fakti që dikush e ka ruajtur. Posta që mbërrin nga një adresë nuk shkruan asgjë, as një dërgim përmes kësaj API-je.

Libri i adresave i përket hapësirës së punës dhe jo një personi, ndaj një kontakt i ruajtur nga cilido anëtar është kontakti që sheh çdo anëtar dhe çdo çelës. create e shkruan source si manual dhe e vendos kontaktin te audienca e parazgjedhur në çastin që shkruhet. Emërtoni listat tuaja te audienceIds që kontakti të hyjë në to në të njëjtën thirrje, gjë që kërkon edhe audiences:write, ose shtojeni kontaktin më vonë me audiences->addContact, që trajtohet te faqja e audiencave. setAudiences thotë saktësisht në cilat lista është një kontakt, me një thirrje.

contacts->list kthen një OpenEmail\Result\Page, ndaj rreshtat janë te $page->items dhe përshkimi ndjek $page->nextCursor sa kohë që $page->hasMore është true. listAll i kthen të gjithë rreshtat si një array të vetëm, dhe iterate kthen një Generator që i jep një nga një. get, create, update, save dhe setAudiences kthejnë secili një kontakt si array me çelësa në camelCase, të njëjtin rresht plus audiences. Libri i adresave nuk ka kufi, prandaj kjo rrugë faqos në vend që të kthejë një array që ndalet në heshtje te 200.

setAudiences($email, ['audienceIds' => [...]]) thotë saktësisht në cilat audienca është një kontakt, me një kërkesë. Kontakti hyn në çdo audiencë të listuar ku ende nuk është dhe del nga çdo tjetër, dhe thirrja kthen kontaktin pas ndryshimit, me audiences e tij. Kërkon audiences:write, sepse shkruan anëtarësime dhe jo kontaktin, dhe përsëritja e saj nuk ndryshon asgjë, ndaj klienti e riprovon pas një dështimi të rrjetit.

listPeople liston personat që shfaq faqja Kontaktet në aplikacion: kontaktet e ruajtura dhe çdo adresë e parë në postë, secila me saved, threads dhe lastAt. list janë vetëm kontaktet e ruajtura. Kthen një OpenEmail\Result\PeoplePage, e cila i shton seen te items, hasMore dhe nextCursor. Adresat e para në postë vijnë vetëm kur çelësi mban edhe threads:read, dhe $page->seen thotë nëse erdhën. sort: është recent, name ose threads, dhe OpenEmail\Constants\PeopleSorts i emërton. q: kërkon te emrat, adresat dhe shënimet, dhe blocked: true mban personat që i bllokon lista e bllokimit e hapësirës së punës, përfshirë rregullat për domene të tëra. blockedBy emërton rregullin në çdo rresht.

use OpenEmail\Constants\PeopleSorts; $page = $client->contacts->listPeople(sort: PeopleSorts::THREADS, limit: 50); foreach ($page as $person) {    if (!$person['saved'] && $person['threads'] > 5) {        $client->contacts->save($person['email']);    }} $blocked = $client->contacts->listAllPeople(blocked: true);echo $page->seen ? 'saved and seen' : 'saved only', ', ', count($blocked), ' blocked', PHP_EOL;

save($email), me një array opsional me name dhe notes, është Shto te kontaktet dhe Mbaje te kontaktet: ruan një adresë që ende nuk është kontakt, mban si të ruajtur me dorë një të regjistruar nga një dërgim dhe kthen një të fshirë. delete është Fshi: heq kontaktin e ruajtur dhe fsheh adresën, që kompozuesi të mos e regjistrojë sërish, dhe pranon edhe një adresë të parë vetëm në postë. wasSaved në array-in që kthen thotë cili rast ishte. deleteMany fshin deri në 200 në një thirrje.

$client->contacts->save('[email protected]', ['name' => 'Grace Hopper']); $contact = $client->contacts->setPhoto('[email protected]', file_get_contents('photo.jpg'), contentType: 'image/jpeg');echo $contact['photoUrl'], PHP_EOL; $client->contacts->setPhoto('[email protected]', new \SplFileInfo('avatar.png')); $client->contacts->removePhoto('[email protected]');$client->contacts->deleteMany(['[email protected]', '[email protected]']);

block($email) vendos adresën në listën e bllokimit të hapësirës së punës që posta prej saj të refuzohet, duke hedhur çdo etiketë me plus, dhe unblock($email) heq çdo rregull që e bllokon. Të dyja kërkojnë settings:write, sepse ndryshojnë listën e bllokimit dhe jo kontaktin, dhe asnjëra nuk kërkon që adresa të jetë kontakt.

listThreads($email) faqos nëpër thread-et ku adresa shkroi ose ku iu shkrua, në çdo dosje, dhe listAllThreads e iterateThreads i përshkojnë ato. activity($email) kthen numrat pas skedës Aktiviteti të një kontakti: të marrat dhe të dërguarat për çdo interval, thread-et që presin përgjigjen tuaj dhe kohën mediane të përgjigjes në secilin drejtim. Të dyja kërkojnë threads:read.

$threads = $client->contacts->listThreads('[email protected]', q: 'invoice'); $activity = $client->contacts->activity(    '[email protected]',    minutes: 30 * 24 * 60,    grain: 'day',    offsetMinutes: intdiv((int) date('Z'), 60),); echo count($threads), ' threads, ', $activity['totals']['waiting'], ' waiting on you', PHP_EOL;