Automatizimet
`automations->list`, `get`, `create`, `update`, `publish`, `pause`, `resume`, `archive`, `duplicate`, `delete`, `sendTest`, `stats`, `listVersions`, `restoreVersion`, `listStarters`, `listEnrollments`, `getEnrollment`, `enroll` dhe `exitEnrollment`, me `events->send`, `sendBatch` dhe `listNames`.
Çdo metodë
use OpenEmail\Constants\AutomationEnrollmentStatuses;use OpenEmail\Constants\AutomationTriggerKinds; $automation = $client->automations->create([ 'name' => 'Welcome series', 'starter' => 'welcome-series', 'settings' => ['timezone' => 'Europe/London'],]); $definition = $automation['definition'];$definition['trigger'] = ['kind' => AutomationTriggerKinds::EVENT, 'eventName' => 'trial.started', 'filters' => []]; $saved = $client->automations->update($automation['id'], [ 'definition' => $definition, 'expectedUpdatedAt' => $automation['updatedAt'],]); foreach ($saved['problems'] as $problem) { if ($problem['blocking']) { throw new \RuntimeException($problem['message']); }} $client->automations->sendTest($saved['id'], ['stepKey' => $saved['definition']['entry'] ?? '']);$live = $client->automations->publish($saved['id']); $sent = $client->events->send([ 'name' => 'trial.started', 'email' => '[email protected]', 'properties' => ['plan' => 'starter'], 'createContact' => true,], idempotencyKey: 'trial:[email protected]'); foreach ($client->automations->iterateEnrollments($live['id'], status: AutomationEnrollmentStatuses::ACTIVE) as $enrollment) { if ($enrollment['heldFor'] !== null) { echo $enrollment['contact']['email'], ' ', $enrollment['heldFor'], PHP_EOL; }} $stats = $client->automations->stats($live['id']);$history = $client->contacts->listEvents('[email protected]', name: 'trial.started'); $client->automations->pause($live['id']);$client->automations->resume($live['id']); echo count($sent['enrolled']), ' ', $stats['totals']['entered'], ' ', count($history->items), PHP_EOL;Një automatizim mban një definition skice dhe versionin published që ekzekutohet. update ndryshon skicën dhe cilësimet, dhe publish e ngrin skicën si versionin e radhës dhe e aktivizon automatizimin. problems thotë çfarë ende e pengon një skicë të publikohet, dhe expectedUpdatedAt refuzon me 409 version_conflict një ruajtje që do të mbishkruante atë të dikujt tjetër.
Leximi kërkon automations:read dhe ndryshimi kërkon automations:write. publish, resume dhe sendTest kërkojnë edhe emails:send. events->send dhe events->sendBatch kërkojnë contacts:write, dhe contacts->listEvents kërkon contacts:read. delete i kërkon një tokeni qasjeje OAuth një kod verifikimi, ndërsa një çelësi API kurrë.
events->sendBatch merr deri në 100 ngjarje dhe nuk hedh kurrë gabim për një ngjarje të keqe: përgjigjja liston accepted dhe failed, secila me index të ngjarjes në vargun që dërguat.
attributes te një kontakt mban fushat e tij të personalizuara, dhe një automatizim e lexon njërën si attributes.<key>.