sequenzy 2.1.23 → 2.1.30
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cjs/api/resources/accounts/client/Client.d.ts +1 -1
- package/dist/cjs/api/resources/accounts/client/Client.js +1 -1
- package/dist/cjs/api/resources/analytics/client/Client.d.ts +20 -0
- package/dist/cjs/api/resources/analytics/client/Client.js +108 -1
- package/dist/cjs/api/resources/analytics/client/requests/GetMetricsBreakdownRequest.d.ts +27 -0
- package/dist/cjs/api/resources/analytics/client/requests/GetMetricsBreakdownRequest.js +3 -0
- package/dist/cjs/api/resources/analytics/client/requests/GetMetricsRequest.d.ts +4 -0
- package/dist/cjs/api/resources/analytics/client/requests/index.d.ts +1 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestBy.d.ts +8 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestBy.js +11 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestEmailType.d.ts +6 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestEmailType.js +9 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestPeriod.d.ts +8 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownRequestPeriod.js +11 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownResponse.d.ts +14 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownResponse.js +3 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.d.ts +30 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.js +3 -0
- package/dist/cjs/api/resources/analytics/types/GetMetricsResponse.d.ts +4 -0
- package/dist/cjs/api/resources/analytics/types/index.d.ts +5 -0
- package/dist/cjs/api/resources/analytics/types/index.js +5 -0
- package/dist/cjs/api/resources/integrations/client/Client.d.ts +17 -0
- package/dist/cjs/api/resources/integrations/client/Client.js +66 -0
- package/dist/cjs/api/resources/integrations/client/requests/ConnectIntegrationsRequest.d.ts +1 -1
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponse.d.ts +12 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponse.js +3 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.d.ts +11 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.js +3 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.d.ts +4 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js +3 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.d.ts +4 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.js +7 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.d.ts +10 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.js +3 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.d.ts +7 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js +10 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.d.ts +12 -0
- package/dist/cjs/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js +15 -0
- package/dist/cjs/api/resources/integrations/types/index.d.ts +7 -0
- package/dist/cjs/api/resources/integrations/types/index.js +7 -0
- package/dist/cjs/api/types/EmailEvent.d.ts +5 -0
- package/dist/cjs/api/types/EmailEventOutcome.d.ts +8 -0
- package/dist/cjs/api/types/EmailEventOutcome.js +11 -0
- package/dist/cjs/api/types/EmailSend.d.ts +7 -1
- package/dist/cjs/api/types/EmailSendEvent.d.ts +1 -0
- package/dist/cjs/api/types/EmailSendInternalFailureCode.d.ts +1 -1
- package/dist/cjs/api/types/EmailSendInternalFailureCode.js +1 -1
- package/dist/cjs/api/types/EmailSendOutcome.d.ts +8 -0
- package/dist/cjs/api/types/EmailSendOutcome.js +11 -0
- package/dist/cjs/api/types/SenderHealthMetric.d.ts +1 -1
- package/dist/cjs/api/types/SendingStatusPauseReasonKind.d.ts +1 -0
- package/dist/cjs/api/types/SendingStatusPauseReasonKind.js +1 -0
- package/dist/cjs/api/types/SendingStatusSenderHealth.d.ts +4 -0
- package/dist/cjs/api/types/index.d.ts +2 -0
- package/dist/cjs/api/types/index.js +2 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestBy.d.ts +7 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestBy.js +29 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestEmailType.d.ts +7 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestEmailType.js +29 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestPeriod.d.ts +7 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownRequestPeriod.js +29 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownResponse.d.ts +19 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownResponse.js +41 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.d.ts +26 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.js +48 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsResponse.d.ts +2 -0
- package/dist/cjs/serialization/resources/analytics/types/GetMetricsResponse.js +2 -0
- package/dist/cjs/serialization/resources/analytics/types/index.d.ts +5 -0
- package/dist/cjs/serialization/resources/analytics/types/index.js +5 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponse.d.ts +15 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponse.js +37 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.d.ts +13 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.js +35 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.d.ts +10 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js +32 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.d.ts +7 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.js +29 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.d.ts +15 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.js +37 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.d.ts +7 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js +29 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.d.ts +7 -0
- package/dist/cjs/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js +39 -0
- package/dist/cjs/serialization/resources/integrations/types/index.d.ts +7 -0
- package/dist/cjs/serialization/resources/integrations/types/index.js +7 -0
- package/dist/cjs/serialization/types/EmailEvent.d.ts +3 -0
- package/dist/cjs/serialization/types/EmailEvent.js +3 -0
- package/dist/cjs/serialization/types/EmailEventOutcome.d.ts +7 -0
- package/dist/cjs/serialization/types/EmailEventOutcome.js +29 -0
- package/dist/cjs/serialization/types/EmailSend.d.ts +3 -0
- package/dist/cjs/serialization/types/EmailSend.js +3 -0
- package/dist/cjs/serialization/types/EmailSendOutcome.d.ts +7 -0
- package/dist/cjs/serialization/types/EmailSendOutcome.js +29 -0
- package/dist/cjs/serialization/types/SendingStatusPauseReasonKind.d.ts +1 -1
- package/dist/cjs/serialization/types/SendingStatusPauseReasonKind.js +1 -0
- package/dist/cjs/serialization/types/SendingStatusSenderHealth.d.ts +2 -0
- package/dist/cjs/serialization/types/SendingStatusSenderHealth.js +2 -0
- package/dist/cjs/serialization/types/index.d.ts +2 -0
- package/dist/cjs/serialization/types/index.js +2 -0
- package/dist/esm/api/resources/accounts/client/Client.d.ts +1 -1
- package/dist/esm/api/resources/accounts/client/Client.js +1 -1
- package/dist/esm/api/resources/analytics/client/Client.d.ts +20 -0
- package/dist/esm/api/resources/analytics/client/Client.js +108 -1
- package/dist/esm/api/resources/analytics/client/requests/GetMetricsBreakdownRequest.d.ts +27 -0
- package/dist/esm/api/resources/analytics/client/requests/GetMetricsBreakdownRequest.js +2 -0
- package/dist/esm/api/resources/analytics/client/requests/GetMetricsRequest.d.ts +4 -0
- package/dist/esm/api/resources/analytics/client/requests/index.d.ts +1 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestBy.d.ts +8 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestBy.js +8 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestEmailType.d.ts +6 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestEmailType.js +6 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestPeriod.d.ts +8 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownRequestPeriod.js +8 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownResponse.d.ts +14 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownResponse.js +2 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.d.ts +30 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.js +2 -0
- package/dist/esm/api/resources/analytics/types/GetMetricsResponse.d.ts +4 -0
- package/dist/esm/api/resources/analytics/types/index.d.ts +5 -0
- package/dist/esm/api/resources/analytics/types/index.js +5 -0
- package/dist/esm/api/resources/integrations/client/Client.d.ts +17 -0
- package/dist/esm/api/resources/integrations/client/Client.js +66 -0
- package/dist/esm/api/resources/integrations/client/requests/ConnectIntegrationsRequest.d.ts +1 -1
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponse.d.ts +12 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponse.js +2 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.d.ts +11 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.js +2 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.d.ts +4 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js +2 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.d.ts +4 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.js +4 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.d.ts +10 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.js +2 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.d.ts +7 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js +7 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.d.ts +12 -0
- package/dist/esm/api/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js +12 -0
- package/dist/esm/api/resources/integrations/types/index.d.ts +7 -0
- package/dist/esm/api/resources/integrations/types/index.js +7 -0
- package/dist/esm/api/types/EmailEvent.d.ts +5 -0
- package/dist/esm/api/types/EmailEventOutcome.d.ts +8 -0
- package/dist/esm/api/types/EmailEventOutcome.js +8 -0
- package/dist/esm/api/types/EmailSend.d.ts +7 -1
- package/dist/esm/api/types/EmailSendEvent.d.ts +1 -0
- package/dist/esm/api/types/EmailSendInternalFailureCode.d.ts +1 -1
- package/dist/esm/api/types/EmailSendInternalFailureCode.js +1 -1
- package/dist/esm/api/types/EmailSendOutcome.d.ts +8 -0
- package/dist/esm/api/types/EmailSendOutcome.js +8 -0
- package/dist/esm/api/types/SenderHealthMetric.d.ts +1 -1
- package/dist/esm/api/types/SendingStatusPauseReasonKind.d.ts +1 -0
- package/dist/esm/api/types/SendingStatusPauseReasonKind.js +1 -0
- package/dist/esm/api/types/SendingStatusSenderHealth.d.ts +4 -0
- package/dist/esm/api/types/index.d.ts +2 -0
- package/dist/esm/api/types/index.js +2 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestBy.d.ts +7 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestBy.js +3 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestEmailType.d.ts +7 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestEmailType.js +3 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestPeriod.d.ts +7 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownRequestPeriod.js +3 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownResponse.d.ts +19 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownResponse.js +15 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.d.ts +26 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsBreakdownResponseRowsItem.js +22 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsResponse.d.ts +2 -0
- package/dist/esm/serialization/resources/analytics/types/GetMetricsResponse.js +2 -0
- package/dist/esm/serialization/resources/analytics/types/index.d.ts +5 -0
- package/dist/esm/serialization/resources/analytics/types/index.js +5 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponse.d.ts +15 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponse.js +11 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.d.ts +13 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProviders.js +9 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.d.ts +10 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js +6 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.d.ts +7 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponsePaymentProvidersReason.js +3 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.d.ts +15 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItem.js +11 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.d.ts +7 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js +3 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.d.ts +7 -0
- package/dist/esm/serialization/resources/integrations/types/ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js +13 -0
- package/dist/esm/serialization/resources/integrations/types/index.d.ts +7 -0
- package/dist/esm/serialization/resources/integrations/types/index.js +7 -0
- package/dist/esm/serialization/types/EmailEvent.d.ts +3 -0
- package/dist/esm/serialization/types/EmailEvent.js +3 -0
- package/dist/esm/serialization/types/EmailEventOutcome.d.ts +7 -0
- package/dist/esm/serialization/types/EmailEventOutcome.js +3 -0
- package/dist/esm/serialization/types/EmailSend.d.ts +3 -0
- package/dist/esm/serialization/types/EmailSend.js +3 -0
- package/dist/esm/serialization/types/EmailSendOutcome.d.ts +7 -0
- package/dist/esm/serialization/types/EmailSendOutcome.js +3 -0
- package/dist/esm/serialization/types/SendingStatusPauseReasonKind.d.ts +1 -1
- package/dist/esm/serialization/types/SendingStatusPauseReasonKind.js +1 -0
- package/dist/esm/serialization/types/SendingStatusSenderHealth.d.ts +2 -0
- package/dist/esm/serialization/types/SendingStatusSenderHealth.js +2 -0
- package/dist/esm/serialization/types/index.d.ts +2 -0
- package/dist/esm/serialization/types/index.js +2 -0
- package/package.json +1 -1
|
@@ -447,6 +447,7 @@ export class AnalyticsClient {
|
|
|
447
447
|
*
|
|
448
448
|
* @throws {@link Sequenzy.BadRequestError}
|
|
449
449
|
* @throws {@link Sequenzy.UnauthorizedError}
|
|
450
|
+
* @throws {@link Sequenzy.NotFoundError}
|
|
450
451
|
* @throws {@link Sequenzy.ServiceUnavailableError}
|
|
451
452
|
* @throws {@link errors.SequenzyError}
|
|
452
453
|
* @throws {@link errors.SequenzyTimeoutError}
|
|
@@ -458,7 +459,7 @@ export class AnalyticsClient {
|
|
|
458
459
|
return core.HttpResponsePromise.fromPromise(this.__getMetrics(request, requestOptions));
|
|
459
460
|
}
|
|
460
461
|
async __getMetrics(request = {}, requestOptions) {
|
|
461
|
-
const { emailType, end, includeMachineEngagement, mailboxProvider, period, start } = request;
|
|
462
|
+
const { emailType, end, includeMachineEngagement, mailboxProvider, period, recipientDomain, source, start } = request;
|
|
462
463
|
const _queryParams = {
|
|
463
464
|
emailType: emailType != null
|
|
464
465
|
? serializers.GetMetricsRequestEmailType.jsonOrThrow(emailType, {
|
|
@@ -475,6 +476,8 @@ export class AnalyticsClient {
|
|
|
475
476
|
omitUndefined: true,
|
|
476
477
|
})
|
|
477
478
|
: undefined,
|
|
479
|
+
recipientDomain,
|
|
480
|
+
source,
|
|
478
481
|
start: start != null ? start?.toISOString() : undefined,
|
|
479
482
|
};
|
|
480
483
|
const _authRequest = await this._options.authProvider.getAuthRequest();
|
|
@@ -514,6 +517,8 @@ export class AnalyticsClient {
|
|
|
514
517
|
throw new Sequenzy.BadRequestError(_response.error.body, _response.rawResponse);
|
|
515
518
|
case 401:
|
|
516
519
|
throw new Sequenzy.UnauthorizedError(_response.error.body, _response.rawResponse);
|
|
520
|
+
case 404:
|
|
521
|
+
throw new Sequenzy.NotFoundError(_response.error.body, _response.rawResponse);
|
|
517
522
|
case 503:
|
|
518
523
|
throw new Sequenzy.ServiceUnavailableError(_response.error.body, _response.rawResponse);
|
|
519
524
|
default:
|
|
@@ -526,6 +531,108 @@ export class AnalyticsClient {
|
|
|
526
531
|
}
|
|
527
532
|
return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/metrics");
|
|
528
533
|
}
|
|
534
|
+
/**
|
|
535
|
+
* Returns the delivery funnel for each value of one dimension, most sends first, so you can find the email, sequence, provider or domain behind a number and drill into it. Rows count the sends made in the window and the engagement they earned. Defaults to the last 30 days and 25 rows.
|
|
536
|
+
*
|
|
537
|
+
* @param {Sequenzy.GetMetricsBreakdownRequest} request
|
|
538
|
+
* @param {AnalyticsClient.RequestOptions} requestOptions - Request-specific configuration.
|
|
539
|
+
*
|
|
540
|
+
* @throws {@link Sequenzy.BadRequestError}
|
|
541
|
+
* @throws {@link Sequenzy.UnauthorizedError}
|
|
542
|
+
* @throws {@link Sequenzy.ForbiddenError}
|
|
543
|
+
* @throws {@link Sequenzy.NotFoundError}
|
|
544
|
+
* @throws {@link Sequenzy.InternalServerError}
|
|
545
|
+
* @throws {@link errors.SequenzyError}
|
|
546
|
+
* @throws {@link errors.SequenzyTimeoutError}
|
|
547
|
+
*
|
|
548
|
+
* @example
|
|
549
|
+
* await client.analytics.getMetricsBreakdown()
|
|
550
|
+
*/
|
|
551
|
+
getMetricsBreakdown(request = {}, requestOptions) {
|
|
552
|
+
return core.HttpResponsePromise.fromPromise(this.__getMetricsBreakdown(request, requestOptions));
|
|
553
|
+
}
|
|
554
|
+
async __getMetricsBreakdown(request = {}, requestOptions) {
|
|
555
|
+
const { by, emailType, end, includeMachineEngagement, limit, mailboxProvider, period, recipientDomain, source, start, } = request;
|
|
556
|
+
const _queryParams = {
|
|
557
|
+
by: by != null
|
|
558
|
+
? serializers.GetMetricsBreakdownRequestBy.jsonOrThrow(by, {
|
|
559
|
+
unrecognizedObjectKeys: "strip",
|
|
560
|
+
omitUndefined: true,
|
|
561
|
+
})
|
|
562
|
+
: undefined,
|
|
563
|
+
emailType: emailType != null
|
|
564
|
+
? serializers.GetMetricsBreakdownRequestEmailType.jsonOrThrow(emailType, {
|
|
565
|
+
unrecognizedObjectKeys: "strip",
|
|
566
|
+
omitUndefined: true,
|
|
567
|
+
})
|
|
568
|
+
: undefined,
|
|
569
|
+
end: end != null ? end?.toISOString() : undefined,
|
|
570
|
+
includeMachineEngagement,
|
|
571
|
+
limit,
|
|
572
|
+
mailboxProvider,
|
|
573
|
+
period: period != null
|
|
574
|
+
? serializers.GetMetricsBreakdownRequestPeriod.jsonOrThrow(period, {
|
|
575
|
+
unrecognizedObjectKeys: "strip",
|
|
576
|
+
omitUndefined: true,
|
|
577
|
+
})
|
|
578
|
+
: undefined,
|
|
579
|
+
recipientDomain,
|
|
580
|
+
source,
|
|
581
|
+
start: start != null ? start?.toISOString() : undefined,
|
|
582
|
+
};
|
|
583
|
+
const _authRequest = await this._options.authProvider.getAuthRequest();
|
|
584
|
+
const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
|
|
585
|
+
const _response = await core.fetcher({
|
|
586
|
+
url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
|
|
587
|
+
(await core.Supplier.get(this._options.environment)) ??
|
|
588
|
+
environments.SequenzyEnvironment.Default, "metrics/breakdown"),
|
|
589
|
+
method: "GET",
|
|
590
|
+
headers: _headers,
|
|
591
|
+
queryString: core.url
|
|
592
|
+
.queryBuilder()
|
|
593
|
+
.addMany(_queryParams)
|
|
594
|
+
.mergeAdditional(requestOptions?.queryParams)
|
|
595
|
+
.build(),
|
|
596
|
+
timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
|
|
597
|
+
maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
|
|
598
|
+
abortSignal: requestOptions?.abortSignal,
|
|
599
|
+
fetchFn: this._options?.fetch,
|
|
600
|
+
logging: this._options.logging,
|
|
601
|
+
});
|
|
602
|
+
if (_response.ok) {
|
|
603
|
+
return {
|
|
604
|
+
data: serializers.GetMetricsBreakdownResponse.parseOrThrow(_response.body, {
|
|
605
|
+
unrecognizedObjectKeys: "passthrough",
|
|
606
|
+
allowUnrecognizedUnionMembers: true,
|
|
607
|
+
allowUnrecognizedEnumValues: true,
|
|
608
|
+
skipValidation: true,
|
|
609
|
+
breadcrumbsPrefix: ["response"],
|
|
610
|
+
}),
|
|
611
|
+
rawResponse: _response.rawResponse,
|
|
612
|
+
};
|
|
613
|
+
}
|
|
614
|
+
if (_response.error.reason === "status-code") {
|
|
615
|
+
switch (_response.error.statusCode) {
|
|
616
|
+
case 400:
|
|
617
|
+
throw new Sequenzy.BadRequestError(_response.error.body, _response.rawResponse);
|
|
618
|
+
case 401:
|
|
619
|
+
throw new Sequenzy.UnauthorizedError(_response.error.body, _response.rawResponse);
|
|
620
|
+
case 403:
|
|
621
|
+
throw new Sequenzy.ForbiddenError(_response.error.body, _response.rawResponse);
|
|
622
|
+
case 404:
|
|
623
|
+
throw new Sequenzy.NotFoundError(_response.error.body, _response.rawResponse);
|
|
624
|
+
case 500:
|
|
625
|
+
throw new Sequenzy.InternalServerError(_response.error.body, _response.rawResponse);
|
|
626
|
+
default:
|
|
627
|
+
throw new errors.SequenzyError({
|
|
628
|
+
statusCode: _response.error.statusCode,
|
|
629
|
+
body: _response.error.body,
|
|
630
|
+
rawResponse: _response.rawResponse,
|
|
631
|
+
});
|
|
632
|
+
}
|
|
633
|
+
}
|
|
634
|
+
return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/metrics/breakdown");
|
|
635
|
+
}
|
|
529
636
|
/**
|
|
530
637
|
* Returns a paginated list of recipients with their open, click, and unsubscribe events. Use this to sync engagement data to your own database.
|
|
531
638
|
*
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import type * as Sequenzy from "../../../../index.js";
|
|
2
|
+
/**
|
|
3
|
+
* @example
|
|
4
|
+
* {}
|
|
5
|
+
*/
|
|
6
|
+
export interface GetMetricsBreakdownRequest {
|
|
7
|
+
/** Dimension to group by. `email` has one row per campaign, sequence email step and transactional template. */
|
|
8
|
+
by?: Sequenzy.GetMetricsBreakdownRequestBy;
|
|
9
|
+
/** Structural email type filter. Marketer-role personal keys only see the emails their role can open and cannot request transactional. */
|
|
10
|
+
emailType?: Sequenzy.GetMetricsBreakdownRequestEmailType;
|
|
11
|
+
/** End of custom time range (ISO 8601). Must be used with `start`. Max range: 90 days. */
|
|
12
|
+
end?: Date;
|
|
13
|
+
/** Include detected scanner, preview, and tracked asset open/click events. */
|
|
14
|
+
includeMachineEngagement?: boolean;
|
|
15
|
+
/** Number of rows to return. */
|
|
16
|
+
limit?: number;
|
|
17
|
+
/** Recipient mailbox provider filter (e.g. gmail, microsoft, yahoo, icloud). */
|
|
18
|
+
mailboxProvider?: string;
|
|
19
|
+
/** Sliding window over send times. Ignored when start/end are provided. */
|
|
20
|
+
period?: Sequenzy.GetMetricsBreakdownRequestPeriod;
|
|
21
|
+
/** Recipient domain filter (e.g. gmail.com). Case-insensitive. */
|
|
22
|
+
recipientDomain?: string;
|
|
23
|
+
/** Email source filter as `<type>:<id>`: `campaign:<campaignId>`, `sequence:<sequenceId>`, `sequence_step:<email step id>` or `transactional:<transactional email id>`. Returns 404 when the source is not in the company or not visible to the key. */
|
|
24
|
+
source?: string;
|
|
25
|
+
/** Start of custom time range (ISO 8601). Must be used with `end`. */
|
|
26
|
+
start?: Date;
|
|
27
|
+
}
|
|
@@ -14,6 +14,10 @@ export interface GetMetricsRequest {
|
|
|
14
14
|
mailboxProvider?: string;
|
|
15
15
|
/** Sliding time window. Ignored when start/end are provided. */
|
|
16
16
|
period?: Sequenzy.GetMetricsRequestPeriod;
|
|
17
|
+
/** Recipient domain filter (e.g. gmail.com). Case-insensitive. */
|
|
18
|
+
recipientDomain?: string;
|
|
19
|
+
/** Email source filter as `<type>:<id>`: `campaign:<campaignId>`, `sequence:<sequenceId>`, `sequence_step:<email step id>` or `transactional:<transactional email id>`. Responses filtered by recipientDomain or source report replies as 0 and omit the commerce forecast. Returns 404 when the source is not in the company or not visible to the key. */
|
|
20
|
+
source?: string;
|
|
17
21
|
/** Start of custom time range (ISO 8601). Must be used with `end`. */
|
|
18
22
|
start?: Date;
|
|
19
23
|
}
|
|
@@ -3,6 +3,7 @@ export type { GetCampaignMetricsRequest } from "./GetCampaignMetricsRequest.js";
|
|
|
3
3
|
export type { GetCampaignStatsLegacyRequest } from "./GetCampaignStatsLegacyRequest.js";
|
|
4
4
|
export type { GetEmailClientMetricsRequest } from "./GetEmailClientMetricsRequest.js";
|
|
5
5
|
export type { GetLinkClickMetricsRequest } from "./GetLinkClickMetricsRequest.js";
|
|
6
|
+
export type { GetMetricsBreakdownRequest } from "./GetMetricsBreakdownRequest.js";
|
|
6
7
|
export type { GetMetricsRequest } from "./GetMetricsRequest.js";
|
|
7
8
|
export type { GetRecipientsRequest } from "./GetRecipientsRequest.js";
|
|
8
9
|
export type { GetSequenceMetricsRequest } from "./GetSequenceMetricsRequest.js";
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export declare const GetMetricsBreakdownRequestBy: {
|
|
2
|
+
readonly Email: "email";
|
|
3
|
+
readonly Sequence: "sequence";
|
|
4
|
+
readonly EmailType: "email_type";
|
|
5
|
+
readonly MailboxProvider: "mailbox_provider";
|
|
6
|
+
readonly RecipientDomain: "recipient_domain";
|
|
7
|
+
};
|
|
8
|
+
export type GetMetricsBreakdownRequestBy = (typeof GetMetricsBreakdownRequestBy)[keyof typeof GetMetricsBreakdownRequestBy];
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
export declare const GetMetricsBreakdownRequestEmailType: {
|
|
2
|
+
readonly Campaign: "campaign";
|
|
3
|
+
readonly Transactional: "transactional";
|
|
4
|
+
readonly Sequence: "sequence";
|
|
5
|
+
};
|
|
6
|
+
export type GetMetricsBreakdownRequestEmailType = (typeof GetMetricsBreakdownRequestEmailType)[keyof typeof GetMetricsBreakdownRequestEmailType];
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export declare const GetMetricsBreakdownRequestPeriod: {
|
|
2
|
+
readonly OneH: "1h";
|
|
3
|
+
readonly TwentyFourH: "24h";
|
|
4
|
+
readonly SevenD: "7d";
|
|
5
|
+
readonly ThirtyD: "30d";
|
|
6
|
+
readonly NinetyD: "90d";
|
|
7
|
+
};
|
|
8
|
+
export type GetMetricsBreakdownRequestPeriod = (typeof GetMetricsBreakdownRequestPeriod)[keyof typeof GetMetricsBreakdownRequestPeriod];
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type * as Sequenzy from "../../../index.js";
|
|
2
|
+
export interface GetMetricsBreakdownResponse {
|
|
3
|
+
by: string;
|
|
4
|
+
emailType?: string;
|
|
5
|
+
end: Date;
|
|
6
|
+
mailboxProvider?: string;
|
|
7
|
+
/** Applied period, or `custom` when start/end were provided. */
|
|
8
|
+
period?: string;
|
|
9
|
+
recipientDomain?: string;
|
|
10
|
+
rows: Sequenzy.GetMetricsBreakdownResponseRowsItem[];
|
|
11
|
+
source?: string;
|
|
12
|
+
start: Date;
|
|
13
|
+
success: boolean;
|
|
14
|
+
}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
export interface GetMetricsBreakdownResponseRowsItem {
|
|
2
|
+
bounced: number;
|
|
3
|
+
/** Percentage of sent. */
|
|
4
|
+
bounceRate: number;
|
|
5
|
+
clicked: number;
|
|
6
|
+
/** Percentage of delivered. */
|
|
7
|
+
clickRate: number;
|
|
8
|
+
complained: number;
|
|
9
|
+
/** Attributed goal conversions. Provider and domain come from the send each conversion is attributed to. */
|
|
10
|
+
conversions?: number;
|
|
11
|
+
delivered: number;
|
|
12
|
+
/** Percentage of sent. */
|
|
13
|
+
deliveryRate: number;
|
|
14
|
+
/** Secondary label, such as the sequence an email step belongs to. */
|
|
15
|
+
detail?: string | null;
|
|
16
|
+
/** The filter that narrows a later request to this row: `{kind: "source", source: {type, id}}` (pass as `source=<type>:<id>`), `{kind: "email_type", emailType}`, `{kind: "mailbox_provider", mailboxProvider}` or `{kind: "recipient_domain", recipientDomain}`. Null when the row cannot be drilled into. */
|
|
17
|
+
filter?: Record<string, unknown> | null;
|
|
18
|
+
/** Dimension value (an id, email type, provider or domain). Empty when the events predate the column. */
|
|
19
|
+
key: string;
|
|
20
|
+
label: string;
|
|
21
|
+
opened: number;
|
|
22
|
+
/** Percentage of delivered. */
|
|
23
|
+
openRate: number;
|
|
24
|
+
/** Attributed revenue in currency units. */
|
|
25
|
+
revenue?: number;
|
|
26
|
+
sent: number;
|
|
27
|
+
unsubscribed: number;
|
|
28
|
+
/** Percentage of delivered. */
|
|
29
|
+
unsubscribeRate: number;
|
|
30
|
+
}
|
|
@@ -8,6 +8,10 @@ export interface GetMetricsResponse {
|
|
|
8
8
|
/** Echoed back when `mailboxProvider` is provided. */
|
|
9
9
|
mailboxProvider?: string;
|
|
10
10
|
period?: string;
|
|
11
|
+
/** Echoed back, lowercased, when `recipientDomain` is provided. */
|
|
12
|
+
recipientDomain?: string;
|
|
13
|
+
/** Echoed back when `source` is provided. */
|
|
14
|
+
source?: string;
|
|
11
15
|
stats?: Sequenzy.EngagementStats;
|
|
12
16
|
/** Live count of every stored contact in the company. Independent of the requested period. */
|
|
13
17
|
subscriberCount?: number;
|
|
@@ -11,6 +11,11 @@ export * from "./GetLinkClickMetricsRequestEmailType.js";
|
|
|
11
11
|
export * from "./GetLinkClickMetricsRequestPeriod.js";
|
|
12
12
|
export * from "./GetLinkClickMetricsResponse.js";
|
|
13
13
|
export * from "./GetLinkClickMetricsResponseEmailType.js";
|
|
14
|
+
export * from "./GetMetricsBreakdownRequestBy.js";
|
|
15
|
+
export * from "./GetMetricsBreakdownRequestEmailType.js";
|
|
16
|
+
export * from "./GetMetricsBreakdownRequestPeriod.js";
|
|
17
|
+
export * from "./GetMetricsBreakdownResponse.js";
|
|
18
|
+
export * from "./GetMetricsBreakdownResponseRowsItem.js";
|
|
14
19
|
export * from "./GetMetricsRequestEmailType.js";
|
|
15
20
|
export * from "./GetMetricsRequestPeriod.js";
|
|
16
21
|
export * from "./GetMetricsResponse.js";
|
|
@@ -11,6 +11,11 @@ export * from "./GetLinkClickMetricsRequestEmailType.js";
|
|
|
11
11
|
export * from "./GetLinkClickMetricsRequestPeriod.js";
|
|
12
12
|
export * from "./GetLinkClickMetricsResponse.js";
|
|
13
13
|
export * from "./GetLinkClickMetricsResponseEmailType.js";
|
|
14
|
+
export * from "./GetMetricsBreakdownRequestBy.js";
|
|
15
|
+
export * from "./GetMetricsBreakdownRequestEmailType.js";
|
|
16
|
+
export * from "./GetMetricsBreakdownRequestPeriod.js";
|
|
17
|
+
export * from "./GetMetricsBreakdownResponse.js";
|
|
18
|
+
export * from "./GetMetricsBreakdownResponseRowsItem.js";
|
|
14
19
|
export * from "./GetMetricsRequestEmailType.js";
|
|
15
20
|
export * from "./GetMetricsRequestPeriod.js";
|
|
16
21
|
export * from "./GetMetricsResponse.js";
|
|
@@ -182,6 +182,23 @@ export declare class IntegrationsClient {
|
|
|
182
182
|
*/
|
|
183
183
|
listCapabilities(request?: Sequenzy.ListCapabilitiesIntegrationsRequest, requestOptions?: IntegrationsClient.RequestOptions): core.HttpResponsePromise<Sequenzy.ListCapabilitiesIntegrationsResponse>;
|
|
184
184
|
private __listCapabilities;
|
|
185
|
+
/**
|
|
186
|
+
* Suggests integrations to connect next, from what Sequenzy found on the company's website during onboarding: tools on the homepage or on the sign-in page it links to (Clerk, Supabase, PostHog, Segment, Webflow, Wix, WordPress, WooCommerce) or a Shopify storefront. Connected providers are left out. Payment providers are never guessed from the site: when it lists pricing and no payment or commerce integration is connected, paymentProviders lists every payment provider. Requires the account:read scope.
|
|
187
|
+
*
|
|
188
|
+
* @param {IntegrationsClient.RequestOptions} requestOptions - Request-specific configuration.
|
|
189
|
+
*
|
|
190
|
+
* @throws {@link Sequenzy.UnauthorizedError}
|
|
191
|
+
* @throws {@link Sequenzy.ForbiddenError}
|
|
192
|
+
* @throws {@link Sequenzy.NotFoundError}
|
|
193
|
+
* @throws {@link Sequenzy.ServiceUnavailableError}
|
|
194
|
+
* @throws {@link errors.SequenzyError}
|
|
195
|
+
* @throws {@link errors.SequenzyTimeoutError}
|
|
196
|
+
*
|
|
197
|
+
* @example
|
|
198
|
+
* await client.integrations.listSuggestions()
|
|
199
|
+
*/
|
|
200
|
+
listSuggestions(requestOptions?: IntegrationsClient.RequestOptions): core.HttpResponsePromise<Sequenzy.ListSuggestionsIntegrationsResponse>;
|
|
201
|
+
private __listSuggestions;
|
|
185
202
|
/**
|
|
186
203
|
* Queues a manual re-sync for a connected integration - customers and revenue for a payment provider (Stripe, Polar, Paddle, Dodo, Lemon Squeezy, Creem, Chargebee, Whop), the user backfill for Supabase, or the event-history import for PostHog and Segment. The Supabase sync reads the project, schema, and table already configured for the integration and returns 400 when none is configured. PostHog and Segment re-run their event-history imports with credentials stored at connect time and are the supported retry path for failed imports; each restarts from the beginning, already-imported events dedupe, and returns 409 while queued or syncing. Segment requires a saved Unify space ID and Profile API token and covers the most recent 14 days served by the Profile API. Terminal BullMQ failures release imports for retry. Returns immediately; poll the integration to watch syncStatus. Other providers re-sync from the dashboard. Requires the integrations:manage scope.
|
|
187
204
|
*
|
|
@@ -665,6 +665,72 @@ export class IntegrationsClient {
|
|
|
665
665
|
}
|
|
666
666
|
return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/integrations/catalog");
|
|
667
667
|
}
|
|
668
|
+
/**
|
|
669
|
+
* Suggests integrations to connect next, from what Sequenzy found on the company's website during onboarding: tools on the homepage or on the sign-in page it links to (Clerk, Supabase, PostHog, Segment, Webflow, Wix, WordPress, WooCommerce) or a Shopify storefront. Connected providers are left out. Payment providers are never guessed from the site: when it lists pricing and no payment or commerce integration is connected, paymentProviders lists every payment provider. Requires the account:read scope.
|
|
670
|
+
*
|
|
671
|
+
* @param {IntegrationsClient.RequestOptions} requestOptions - Request-specific configuration.
|
|
672
|
+
*
|
|
673
|
+
* @throws {@link Sequenzy.UnauthorizedError}
|
|
674
|
+
* @throws {@link Sequenzy.ForbiddenError}
|
|
675
|
+
* @throws {@link Sequenzy.NotFoundError}
|
|
676
|
+
* @throws {@link Sequenzy.ServiceUnavailableError}
|
|
677
|
+
* @throws {@link errors.SequenzyError}
|
|
678
|
+
* @throws {@link errors.SequenzyTimeoutError}
|
|
679
|
+
*
|
|
680
|
+
* @example
|
|
681
|
+
* await client.integrations.listSuggestions()
|
|
682
|
+
*/
|
|
683
|
+
listSuggestions(requestOptions) {
|
|
684
|
+
return core.HttpResponsePromise.fromPromise(this.__listSuggestions(requestOptions));
|
|
685
|
+
}
|
|
686
|
+
async __listSuggestions(requestOptions) {
|
|
687
|
+
const _authRequest = await this._options.authProvider.getAuthRequest();
|
|
688
|
+
const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
|
|
689
|
+
const _response = await core.fetcher({
|
|
690
|
+
url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
|
|
691
|
+
(await core.Supplier.get(this._options.environment)) ??
|
|
692
|
+
environments.SequenzyEnvironment.Default, "integrations/suggestions"),
|
|
693
|
+
method: "GET",
|
|
694
|
+
headers: _headers,
|
|
695
|
+
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
|
|
696
|
+
timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
|
|
697
|
+
maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
|
|
698
|
+
abortSignal: requestOptions?.abortSignal,
|
|
699
|
+
fetchFn: this._options?.fetch,
|
|
700
|
+
logging: this._options.logging,
|
|
701
|
+
});
|
|
702
|
+
if (_response.ok) {
|
|
703
|
+
return {
|
|
704
|
+
data: serializers.ListSuggestionsIntegrationsResponse.parseOrThrow(_response.body, {
|
|
705
|
+
unrecognizedObjectKeys: "passthrough",
|
|
706
|
+
allowUnrecognizedUnionMembers: true,
|
|
707
|
+
allowUnrecognizedEnumValues: true,
|
|
708
|
+
skipValidation: true,
|
|
709
|
+
breadcrumbsPrefix: ["response"],
|
|
710
|
+
}),
|
|
711
|
+
rawResponse: _response.rawResponse,
|
|
712
|
+
};
|
|
713
|
+
}
|
|
714
|
+
if (_response.error.reason === "status-code") {
|
|
715
|
+
switch (_response.error.statusCode) {
|
|
716
|
+
case 401:
|
|
717
|
+
throw new Sequenzy.UnauthorizedError(_response.error.body, _response.rawResponse);
|
|
718
|
+
case 403:
|
|
719
|
+
throw new Sequenzy.ForbiddenError(_response.error.body, _response.rawResponse);
|
|
720
|
+
case 404:
|
|
721
|
+
throw new Sequenzy.NotFoundError(_response.error.body, _response.rawResponse);
|
|
722
|
+
case 503:
|
|
723
|
+
throw new Sequenzy.ServiceUnavailableError(_response.error.body, _response.rawResponse);
|
|
724
|
+
default:
|
|
725
|
+
throw new errors.SequenzyError({
|
|
726
|
+
statusCode: _response.error.statusCode,
|
|
727
|
+
body: _response.error.body,
|
|
728
|
+
rawResponse: _response.rawResponse,
|
|
729
|
+
});
|
|
730
|
+
}
|
|
731
|
+
}
|
|
732
|
+
return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/integrations/suggestions");
|
|
733
|
+
}
|
|
668
734
|
/**
|
|
669
735
|
* Queues a manual re-sync for a connected integration - customers and revenue for a payment provider (Stripe, Polar, Paddle, Dodo, Lemon Squeezy, Creem, Chargebee, Whop), the user backfill for Supabase, or the event-history import for PostHog and Segment. The Supabase sync reads the project, schema, and table already configured for the integration and returns 400 when none is configured. PostHog and Segment re-run their event-history imports with credentials stored at connect time and are the supported retry path for failed imports; each restarts from the beginning, already-imported events dedupe, and returns 409 while queued or syncing. Segment requires a saved Unify space ID and Profile API token and covers the most recent 14 days served by the Profile API. Terminal BullMQ failures release imports for retry. Returns immediately; poll the integration to watch syncStatus. Other providers re-sync from the dashboard. Requires the integrations:manage scope.
|
|
670
736
|
*
|
|
@@ -16,6 +16,6 @@ export interface ConnectIntegrationsRequest {
|
|
|
16
16
|
providerAccountId?: string;
|
|
17
17
|
/** PostHog and Segment: event delivery scope. Attio: listMap (Sequenzy list id to Attio list id or slug) and syncCompanyFromDomain. SparkLoop: listIds for new referrals. */
|
|
18
18
|
settings?: Sequenzy.ConnectIntegrationsRequestSettings;
|
|
19
|
-
/** Signing secret of the provider webhook. Optional for lemon_squeezy managed provisioning and not used by attio; required for other providers. Lemon Squeezy manual secrets use 16-40 characters. For Chargebee, pass username:password. For RevenueCat, pass at least 16 characters: the authorization header value set on the RevenueCat webhook, or its HMAC signing secret. For Superwall, pass the webhook's whsec_ signing secret, the only credential it needs. For Segment, use 16-153 UTF-8 bytes. For SparkLoop,
|
|
19
|
+
/** Signing secret of the provider webhook. Optional for lemon_squeezy managed provisioning and for sparkloop, and not used by attio; required for other providers. Lemon Squeezy manual secrets use 16-40 characters. For Chargebee, pass username:password. For RevenueCat, pass at least 16 characters: the authorization header value set on the RevenueCat webhook, or its HMAC signing secret. For Superwall, pass the webhook's whsec_ signing secret, the only credential it needs. For Segment, use 16-153 UTF-8 bytes. For SparkLoop, omit it so Sequenzy authenticates deliveries with a secret in the webhook URL it registers, or pass the account's webhook authentication token to verify the SparkLoop-Token header instead. */
|
|
20
20
|
webhookSecret?: string;
|
|
21
21
|
}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type * as Sequenzy from "../../../index.js";
|
|
2
|
+
export interface ListSuggestionsIntegrationsResponse {
|
|
3
|
+
/** Present when the website lists pricing and no payment or commerce integration is connected; null otherwise. */
|
|
4
|
+
paymentProviders: Sequenzy.ListSuggestionsIntegrationsResponsePaymentProviders | null;
|
|
5
|
+
/** False while onboarding is still reading the website, including the tool scan, which can finish a few seconds after the rest. An empty list then means the site has not been scanned yet, not that nothing was found. */
|
|
6
|
+
scanComplete: boolean;
|
|
7
|
+
success: boolean;
|
|
8
|
+
/** Detected providers that are not connected, in suggestion order. */
|
|
9
|
+
suggestions: Sequenzy.ListSuggestionsIntegrationsResponseSuggestionsItem[];
|
|
10
|
+
/** The company website the suggestions were read from. */
|
|
11
|
+
websiteUrl: string | null;
|
|
12
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type * as Sequenzy from "../../../index.js";
|
|
2
|
+
/**
|
|
3
|
+
* Present when the website lists pricing and no payment or commerce integration is connected; null otherwise.
|
|
4
|
+
*/
|
|
5
|
+
export interface ListSuggestionsIntegrationsResponsePaymentProviders {
|
|
6
|
+
/** Pricing plans read from the website or entered in settings. */
|
|
7
|
+
pricingPlanCount: number;
|
|
8
|
+
/** Every available payment provider. */
|
|
9
|
+
providers: Sequenzy.ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem[];
|
|
10
|
+
reason: Sequenzy.ListSuggestionsIntegrationsResponsePaymentProvidersReason;
|
|
11
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
export declare const ListSuggestionsIntegrationsResponsePaymentProvidersReason: {
|
|
2
|
+
readonly PricingFound: "pricing_found";
|
|
3
|
+
};
|
|
4
|
+
export type ListSuggestionsIntegrationsResponsePaymentProvidersReason = (typeof ListSuggestionsIntegrationsResponsePaymentProvidersReason)[keyof typeof ListSuggestionsIntegrationsResponsePaymentProvidersReason];
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type * as Sequenzy from "../../../index.js";
|
|
2
|
+
export interface ListSuggestionsIntegrationsResponseSuggestionsItem {
|
|
3
|
+
category: string;
|
|
4
|
+
/** Where the provider was found. storefront means the site runs on Shopify. */
|
|
5
|
+
evidence: Sequenzy.ListSuggestionsIntegrationsResponseSuggestionsItemEvidence;
|
|
6
|
+
name: string;
|
|
7
|
+
provider: Sequenzy.ListSuggestionsIntegrationsResponseSuggestionsItemProvider;
|
|
8
|
+
/** The myshopify.com domain for a Shopify suggestion when one was found; null otherwise. */
|
|
9
|
+
shopDomain: string | null;
|
|
10
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/** Where the provider was found. storefront means the site runs on Shopify. */
|
|
2
|
+
export declare const ListSuggestionsIntegrationsResponseSuggestionsItemEvidence: {
|
|
3
|
+
readonly Homepage: "homepage";
|
|
4
|
+
readonly SignInPage: "sign_in_page";
|
|
5
|
+
readonly Storefront: "storefront";
|
|
6
|
+
};
|
|
7
|
+
export type ListSuggestionsIntegrationsResponseSuggestionsItemEvidence = (typeof ListSuggestionsIntegrationsResponseSuggestionsItemEvidence)[keyof typeof ListSuggestionsIntegrationsResponseSuggestionsItemEvidence];
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// This file was auto-generated by Fern from our API Definition.
|
|
2
|
+
/** Where the provider was found. storefront means the site runs on Shopify. */
|
|
3
|
+
export const ListSuggestionsIntegrationsResponseSuggestionsItemEvidence = {
|
|
4
|
+
Homepage: "homepage",
|
|
5
|
+
SignInPage: "sign_in_page",
|
|
6
|
+
Storefront: "storefront",
|
|
7
|
+
};
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
export declare const ListSuggestionsIntegrationsResponseSuggestionsItemProvider: {
|
|
2
|
+
readonly Shopify: "shopify";
|
|
3
|
+
readonly Clerk: "clerk";
|
|
4
|
+
readonly Supabase: "supabase";
|
|
5
|
+
readonly Posthog: "posthog";
|
|
6
|
+
readonly Segment: "segment";
|
|
7
|
+
readonly Woocommerce: "woocommerce";
|
|
8
|
+
readonly Wordpress: "wordpress";
|
|
9
|
+
readonly Webflow: "webflow";
|
|
10
|
+
readonly Wix: "wix";
|
|
11
|
+
};
|
|
12
|
+
export type ListSuggestionsIntegrationsResponseSuggestionsItemProvider = (typeof ListSuggestionsIntegrationsResponseSuggestionsItemProvider)[keyof typeof ListSuggestionsIntegrationsResponseSuggestionsItemProvider];
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
// This file was auto-generated by Fern from our API Definition.
|
|
2
|
+
export const ListSuggestionsIntegrationsResponseSuggestionsItemProvider = {
|
|
3
|
+
Shopify: "shopify",
|
|
4
|
+
Clerk: "clerk",
|
|
5
|
+
Supabase: "supabase",
|
|
6
|
+
Posthog: "posthog",
|
|
7
|
+
Segment: "segment",
|
|
8
|
+
Woocommerce: "woocommerce",
|
|
9
|
+
Wordpress: "wordpress",
|
|
10
|
+
Webflow: "webflow",
|
|
11
|
+
Wix: "wix",
|
|
12
|
+
};
|
|
@@ -13,6 +13,13 @@ export * from "./ListActivityIntegrationsRequestStatus.js";
|
|
|
13
13
|
export * from "./ListActivityIntegrationsResponse.js";
|
|
14
14
|
export * from "./ListCapabilitiesIntegrationsResponse.js";
|
|
15
15
|
export * from "./ListIntegrationsResponse.js";
|
|
16
|
+
export * from "./ListSuggestionsIntegrationsResponse.js";
|
|
17
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProviders.js";
|
|
18
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js";
|
|
19
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProvidersReason.js";
|
|
20
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItem.js";
|
|
21
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js";
|
|
22
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js";
|
|
16
23
|
export * from "./SyncIntegrationsResponse.js";
|
|
17
24
|
export * from "./SyncIntegrationsResponseSyncTarget.js";
|
|
18
25
|
export * from "./UpdateSyncIntegrationsResponse.js";
|
|
@@ -13,6 +13,13 @@ export * from "./ListActivityIntegrationsRequestStatus.js";
|
|
|
13
13
|
export * from "./ListActivityIntegrationsResponse.js";
|
|
14
14
|
export * from "./ListCapabilitiesIntegrationsResponse.js";
|
|
15
15
|
export * from "./ListIntegrationsResponse.js";
|
|
16
|
+
export * from "./ListSuggestionsIntegrationsResponse.js";
|
|
17
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProviders.js";
|
|
18
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProvidersProvidersItem.js";
|
|
19
|
+
export * from "./ListSuggestionsIntegrationsResponsePaymentProvidersReason.js";
|
|
20
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItem.js";
|
|
21
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItemEvidence.js";
|
|
22
|
+
export * from "./ListSuggestionsIntegrationsResponseSuggestionsItemProvider.js";
|
|
16
23
|
export * from "./SyncIntegrationsResponse.js";
|
|
17
24
|
export * from "./SyncIntegrationsResponseSyncTarget.js";
|
|
18
25
|
export * from "./UpdateSyncIntegrationsResponse.js";
|
|
@@ -18,7 +18,12 @@ export interface EmailEvent {
|
|
|
18
18
|
eventType?: Sequenzy.EmailEventEventType;
|
|
19
19
|
id?: string;
|
|
20
20
|
ipAddress?: string | null;
|
|
21
|
+
/** Event details. Receiver replies (recipients[].diagnosticCode) are masked for bounced and blocked outcomes, generic for failed ones, and kept for delays only when the sender caused them. Sending infrastructure is never included. */
|
|
21
22
|
metadata?: Record<string, unknown>;
|
|
23
|
+
/** Why the email did not arrive. "bounced": the address cannot take mail. "blocked": the receiver refused because of the sender (spam or content, the sending domain, policy, or its SPF, DKIM or DMARC). "delayed": still retrying. "failed": we could not deliver it. Null for emails that arrived or have not finished. */
|
|
24
|
+
outcome?: Sequenzy.EmailEventOutcome | null;
|
|
25
|
+
/** One plain sentence about the outcome, with the receiver's status code when there is one. Null when outcome is null. */
|
|
26
|
+
reason?: string | null;
|
|
22
27
|
subscriberId?: string | null;
|
|
23
28
|
transactionalEmailId?: string | null;
|
|
24
29
|
userAgent?: string | null;
|