@getlatedev/node 0.2.935 → 0.2.937

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/index.d.mts CHANGED
@@ -10539,7 +10539,7 @@ type status18 = 'success' | 'failed';
10539
10539
  */
10540
10540
  type WebhookPayloadAccountAdsInitialSyncCompleted = {
10541
10541
  /**
10542
- * Stable webhook event ID
10542
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10543
10543
  */
10544
10544
  id: string;
10545
10545
  event: 'account.ads.initial_sync_completed';
@@ -10660,7 +10660,7 @@ type errorCategory2 = 'token_invalid' | 'permission_denied' | 'no_ad_accounts' |
10660
10660
  */
10661
10661
  type WebhookPayloadAccountConnected = {
10662
10662
  /**
10663
- * Stable webhook event ID
10663
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10664
10664
  */
10665
10665
  id: string;
10666
10666
  event: 'account.connected';
@@ -10688,7 +10688,7 @@ type event2 = 'account.connected';
10688
10688
  */
10689
10689
  type WebhookPayloadAccountDisconnected = {
10690
10690
  /**
10691
- * Stable webhook event ID
10691
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10692
10692
  */
10693
10693
  id: string;
10694
10694
  event: 'account.disconnected';
@@ -10737,7 +10737,7 @@ type disconnectionType = 'intentional' | 'unintentional';
10737
10737
  */
10738
10738
  type WebhookPayloadAdStatusChanged = {
10739
10739
  /**
10740
- * Stable webhook event ID
10740
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10741
10741
  */
10742
10742
  id: string;
10743
10743
  event: 'ad.status_changed';
@@ -10870,7 +10870,7 @@ type level = 'CAMPAIGN' | 'AD_SET' | 'AD';
10870
10870
  */
10871
10871
  type WebhookPayloadAnalyticsSynced = {
10872
10872
  /**
10873
- * Stable webhook event ID
10873
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10874
10874
  */
10875
10875
  id: string;
10876
10876
  event: 'analytics.synced';
@@ -10918,6 +10918,9 @@ type event5 = 'analytics.synced';
10918
10918
  *
10919
10919
  */
10920
10920
  type WebhookPayloadCallEnded = {
10921
+ /**
10922
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10923
+ */
10921
10924
  id: string;
10922
10925
  event: 'call.ended';
10923
10926
  call: {
@@ -10983,6 +10986,9 @@ type event6 = 'call.ended';
10983
10986
  *
10984
10987
  */
10985
10988
  type WebhookPayloadCallFailed = {
10989
+ /**
10990
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10991
+ */
10986
10992
  id: string;
10987
10993
  event: 'call.failed';
10988
10994
  call: {
@@ -11013,6 +11019,9 @@ type event7 = 'call.failed';
11013
11019
  *
11014
11020
  */
11015
11021
  type WebhookPayloadCallPermissionRequest = {
11022
+ /**
11023
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11024
+ */
11016
11025
  id: string;
11017
11026
  event: 'call.permission_request';
11018
11027
  permission: {
@@ -11047,7 +11056,7 @@ type response = 'accept' | 'reject';
11047
11056
  */
11048
11057
  type WebhookPayloadCallReceived = {
11049
11058
  /**
11050
- * Stable webhook event ID
11059
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11051
11060
  */
11052
11061
  id: string;
11053
11062
  event: 'call.received';
@@ -11094,7 +11103,7 @@ type event9 = 'call.received';
11094
11103
  */
11095
11104
  type WebhookPayloadComment = {
11096
11105
  /**
11097
- * Stable webhook event ID
11106
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11098
11107
  */
11099
11108
  id: string;
11100
11109
  event: 'comment.received';
@@ -11251,7 +11260,7 @@ type platform12 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'linkedin'
11251
11260
  */
11252
11261
  type WebhookPayloadConversationControlChanged = {
11253
11262
  /**
11254
- * Stable webhook event ID
11263
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11255
11264
  */
11256
11265
  id: string;
11257
11266
  event: 'conversation.control_changed';
@@ -11295,7 +11304,7 @@ type previousOwner = 'app' | 'ai_agent' | 'other';
11295
11304
  */
11296
11305
  type WebhookPayloadConversationStarted = {
11297
11306
  /**
11298
- * Stable webhook event ID
11307
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11299
11308
  */
11300
11309
  id: string;
11301
11310
  event: 'conversation.started';
@@ -11321,7 +11330,7 @@ type event12 = 'conversation.started';
11321
11330
  */
11322
11331
  type WebhookPayloadExternalPost = {
11323
11332
  /**
11324
- * Stable webhook event ID
11333
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11325
11334
  */
11326
11335
  id: string;
11327
11336
  event: 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
@@ -11346,7 +11355,7 @@ type event13 = 'post.external.created' | 'post.external.updated' | 'post.externa
11346
11355
  */
11347
11356
  type WebhookPayloadLead = {
11348
11357
  /**
11349
- * Stable webhook event ID
11358
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11350
11359
  */
11351
11360
  id: string;
11352
11361
  event: 'lead.received';
@@ -11416,7 +11425,7 @@ type platform13 = 'facebook';
11416
11425
  */
11417
11426
  type WebhookPayloadMessage = {
11418
11427
  /**
11419
- * Stable webhook event ID
11428
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11420
11429
  */
11421
11430
  id: string;
11422
11431
  event: 'message.received';
@@ -11986,6 +11995,9 @@ type contactsOrigin = 'contact_request' | 'other';
11986
11995
  *
11987
11996
  */
11988
11997
  type WebhookPayloadMessageDeleted = {
11998
+ /**
11999
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12000
+ */
11989
12001
  id: string;
11990
12002
  event: 'message.deleted';
11991
12003
  message: InboxWebhookMessage;
@@ -12013,6 +12025,9 @@ type event16 = 'message.deleted';
12013
12025
  *
12014
12026
  */
12015
12027
  type WebhookPayloadMessageDeliveryStatus = {
12028
+ /**
12029
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12030
+ */
12016
12031
  id: string;
12017
12032
  event: 'message.delivered' | 'message.read' | 'message.failed';
12018
12033
  message: InboxWebhookMessage;
@@ -12063,6 +12078,9 @@ type event17 = 'message.delivered' | 'message.read' | 'message.failed';
12063
12078
  *
12064
12079
  */
12065
12080
  type WebhookPayloadMessageEdited = {
12081
+ /**
12082
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12083
+ */
12066
12084
  id: string;
12067
12085
  event: 'message.edited';
12068
12086
  message: InboxWebhookMessage;
@@ -12091,7 +12109,7 @@ type event18 = 'message.edited';
12091
12109
  */
12092
12110
  type WebhookPayloadMessageSent = {
12093
12111
  /**
12094
- * Stable webhook event ID
12112
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12095
12113
  */
12096
12114
  id: string;
12097
12115
  event: 'message.sent';
@@ -12313,7 +12331,7 @@ type source3 = 'whatsapp_business_app' | 'cloud_api' | 'meta_business_agent';
12313
12331
  */
12314
12332
  type WebhookPayloadPhoneNumberStockAvailable = {
12315
12333
  /**
12316
- * Stable webhook event ID
12334
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12317
12335
  */
12318
12336
  id: string;
12319
12337
  event: 'phone_number.stock_available';
@@ -12355,7 +12373,7 @@ type event20 = 'phone_number.stock_available';
12355
12373
  */
12356
12374
  type WebhookPayloadPost = {
12357
12375
  /**
12358
- * Stable webhook event ID
12376
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12359
12377
  */
12360
12378
  id: string;
12361
12379
  event: 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
@@ -12375,6 +12393,14 @@ type WebhookPayloadPost = {
12375
12393
  platformPostId?: string;
12376
12394
  publishedUrl?: string;
12377
12395
  error?: string;
12396
+ /**
12397
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12398
+ */
12399
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12400
+ /**
12401
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
12402
+ */
12403
+ errorSource?: 'user' | 'platform' | 'system';
12378
12404
  platformError?: PostPlatformError;
12379
12405
  }>;
12380
12406
  /**
@@ -12412,7 +12438,7 @@ type event21 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.parti
12412
12438
  */
12413
12439
  type WebhookPayloadPostPlatform = {
12414
12440
  /**
12415
- * Stable webhook event ID.
12441
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12416
12442
  */
12417
12443
  id: string;
12418
12444
  event: 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
@@ -12438,6 +12464,14 @@ type WebhookPayloadPostPlatform = {
12438
12464
  platformPostId?: string;
12439
12465
  publishedUrl?: string;
12440
12466
  error?: string;
12467
+ /**
12468
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12469
+ */
12470
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12471
+ /**
12472
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
12473
+ */
12474
+ errorSource?: 'user' | 'platform' | 'system';
12441
12475
  platformError?: PostPlatformError;
12442
12476
  }>;
12443
12477
  /**
@@ -12471,6 +12505,14 @@ type WebhookPayloadPostPlatform = {
12471
12505
  * Error message from the platform. Present on `failed` only.
12472
12506
  */
12473
12507
  error?: string;
12508
+ /**
12509
+ * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12510
+ */
12511
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12512
+ /**
12513
+ * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
12514
+ */
12515
+ errorSource?: 'user' | 'platform' | 'system';
12474
12516
  /**
12475
12517
  * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
12476
12518
  */
@@ -12500,7 +12542,7 @@ type status20 = 'published' | 'failed' | 'deleted';
12500
12542
  */
12501
12543
  type WebhookPayloadReaction = {
12502
12544
  /**
12503
- * Stable webhook event ID
12545
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12504
12546
  */
12505
12547
  id: string;
12506
12548
  event: 'reaction.received';
@@ -12554,7 +12596,7 @@ type action = 'added' | 'removed';
12554
12596
  */
12555
12597
  type WebhookPayloadReferral = {
12556
12598
  /**
12557
- * Stable webhook event ID
12599
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12558
12600
  */
12559
12601
  id: string;
12560
12602
  event: 'referral.received';
@@ -12624,7 +12666,7 @@ type event24 = 'referral.received';
12624
12666
  */
12625
12667
  type WebhookPayloadReviewNew = {
12626
12668
  /**
12627
- * Stable webhook event ID
12669
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12628
12670
  */
12629
12671
  id: string;
12630
12672
  event: 'review.new';
@@ -12655,7 +12697,7 @@ type event25 = 'review.new';
12655
12697
  */
12656
12698
  type WebhookPayloadReviewUpdated = {
12657
12699
  /**
12658
- * Stable webhook event ID
12700
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12659
12701
  */
12660
12702
  id: string;
12661
12703
  event: 'review.updated';
@@ -12680,7 +12722,7 @@ type event26 = 'review.updated';
12680
12722
  */
12681
12723
  type WebhookPayloadTest = {
12682
12724
  /**
12683
- * Stable webhook event ID
12725
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12684
12726
  */
12685
12727
  id: string;
12686
12728
  event: 'webhook.test';
@@ -12706,7 +12748,7 @@ type event27 = 'webhook.test';
12706
12748
  */
12707
12749
  type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
12708
12750
  /**
12709
- * Stable webhook event ID
12751
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12710
12752
  */
12711
12753
  id: string;
12712
12754
  event: 'whatsapp.account.name_status_updated';
@@ -12755,7 +12797,7 @@ type status21 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
12755
12797
  */
12756
12798
  type WebhookPayloadWhatsAppTemplateCategoryUpdated = {
12757
12799
  /**
12758
- * Stable webhook event ID
12800
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12759
12801
  */
12760
12802
  id: string;
12761
12803
  event: 'whatsapp.template.category_updated';
@@ -12835,7 +12877,7 @@ type scheduledCategory = 'UTILITY' | 'MARKETING' | 'AUTHENTICATION';
12835
12877
  */
12836
12878
  type WebhookPayloadWhatsAppTemplateStatusUpdated = {
12837
12879
  /**
12838
- * Stable webhook event ID
12880
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12839
12881
  */
12840
12882
  id: string;
12841
12883
  event: 'whatsapp.template.status_updated';
package/dist/index.d.ts CHANGED
@@ -10539,7 +10539,7 @@ type status18 = 'success' | 'failed';
10539
10539
  */
10540
10540
  type WebhookPayloadAccountAdsInitialSyncCompleted = {
10541
10541
  /**
10542
- * Stable webhook event ID
10542
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10543
10543
  */
10544
10544
  id: string;
10545
10545
  event: 'account.ads.initial_sync_completed';
@@ -10660,7 +10660,7 @@ type errorCategory2 = 'token_invalid' | 'permission_denied' | 'no_ad_accounts' |
10660
10660
  */
10661
10661
  type WebhookPayloadAccountConnected = {
10662
10662
  /**
10663
- * Stable webhook event ID
10663
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10664
10664
  */
10665
10665
  id: string;
10666
10666
  event: 'account.connected';
@@ -10688,7 +10688,7 @@ type event2 = 'account.connected';
10688
10688
  */
10689
10689
  type WebhookPayloadAccountDisconnected = {
10690
10690
  /**
10691
- * Stable webhook event ID
10691
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10692
10692
  */
10693
10693
  id: string;
10694
10694
  event: 'account.disconnected';
@@ -10737,7 +10737,7 @@ type disconnectionType = 'intentional' | 'unintentional';
10737
10737
  */
10738
10738
  type WebhookPayloadAdStatusChanged = {
10739
10739
  /**
10740
- * Stable webhook event ID
10740
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10741
10741
  */
10742
10742
  id: string;
10743
10743
  event: 'ad.status_changed';
@@ -10870,7 +10870,7 @@ type level = 'CAMPAIGN' | 'AD_SET' | 'AD';
10870
10870
  */
10871
10871
  type WebhookPayloadAnalyticsSynced = {
10872
10872
  /**
10873
- * Stable webhook event ID
10873
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10874
10874
  */
10875
10875
  id: string;
10876
10876
  event: 'analytics.synced';
@@ -10918,6 +10918,9 @@ type event5 = 'analytics.synced';
10918
10918
  *
10919
10919
  */
10920
10920
  type WebhookPayloadCallEnded = {
10921
+ /**
10922
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10923
+ */
10921
10924
  id: string;
10922
10925
  event: 'call.ended';
10923
10926
  call: {
@@ -10983,6 +10986,9 @@ type event6 = 'call.ended';
10983
10986
  *
10984
10987
  */
10985
10988
  type WebhookPayloadCallFailed = {
10989
+ /**
10990
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10991
+ */
10986
10992
  id: string;
10987
10993
  event: 'call.failed';
10988
10994
  call: {
@@ -11013,6 +11019,9 @@ type event7 = 'call.failed';
11013
11019
  *
11014
11020
  */
11015
11021
  type WebhookPayloadCallPermissionRequest = {
11022
+ /**
11023
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11024
+ */
11016
11025
  id: string;
11017
11026
  event: 'call.permission_request';
11018
11027
  permission: {
@@ -11047,7 +11056,7 @@ type response = 'accept' | 'reject';
11047
11056
  */
11048
11057
  type WebhookPayloadCallReceived = {
11049
11058
  /**
11050
- * Stable webhook event ID
11059
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11051
11060
  */
11052
11061
  id: string;
11053
11062
  event: 'call.received';
@@ -11094,7 +11103,7 @@ type event9 = 'call.received';
11094
11103
  */
11095
11104
  type WebhookPayloadComment = {
11096
11105
  /**
11097
- * Stable webhook event ID
11106
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11098
11107
  */
11099
11108
  id: string;
11100
11109
  event: 'comment.received';
@@ -11251,7 +11260,7 @@ type platform12 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'linkedin'
11251
11260
  */
11252
11261
  type WebhookPayloadConversationControlChanged = {
11253
11262
  /**
11254
- * Stable webhook event ID
11263
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11255
11264
  */
11256
11265
  id: string;
11257
11266
  event: 'conversation.control_changed';
@@ -11295,7 +11304,7 @@ type previousOwner = 'app' | 'ai_agent' | 'other';
11295
11304
  */
11296
11305
  type WebhookPayloadConversationStarted = {
11297
11306
  /**
11298
- * Stable webhook event ID
11307
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11299
11308
  */
11300
11309
  id: string;
11301
11310
  event: 'conversation.started';
@@ -11321,7 +11330,7 @@ type event12 = 'conversation.started';
11321
11330
  */
11322
11331
  type WebhookPayloadExternalPost = {
11323
11332
  /**
11324
- * Stable webhook event ID
11333
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11325
11334
  */
11326
11335
  id: string;
11327
11336
  event: 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
@@ -11346,7 +11355,7 @@ type event13 = 'post.external.created' | 'post.external.updated' | 'post.externa
11346
11355
  */
11347
11356
  type WebhookPayloadLead = {
11348
11357
  /**
11349
- * Stable webhook event ID
11358
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11350
11359
  */
11351
11360
  id: string;
11352
11361
  event: 'lead.received';
@@ -11416,7 +11425,7 @@ type platform13 = 'facebook';
11416
11425
  */
11417
11426
  type WebhookPayloadMessage = {
11418
11427
  /**
11419
- * Stable webhook event ID
11428
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11420
11429
  */
11421
11430
  id: string;
11422
11431
  event: 'message.received';
@@ -11986,6 +11995,9 @@ type contactsOrigin = 'contact_request' | 'other';
11986
11995
  *
11987
11996
  */
11988
11997
  type WebhookPayloadMessageDeleted = {
11998
+ /**
11999
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12000
+ */
11989
12001
  id: string;
11990
12002
  event: 'message.deleted';
11991
12003
  message: InboxWebhookMessage;
@@ -12013,6 +12025,9 @@ type event16 = 'message.deleted';
12013
12025
  *
12014
12026
  */
12015
12027
  type WebhookPayloadMessageDeliveryStatus = {
12028
+ /**
12029
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12030
+ */
12016
12031
  id: string;
12017
12032
  event: 'message.delivered' | 'message.read' | 'message.failed';
12018
12033
  message: InboxWebhookMessage;
@@ -12063,6 +12078,9 @@ type event17 = 'message.delivered' | 'message.read' | 'message.failed';
12063
12078
  *
12064
12079
  */
12065
12080
  type WebhookPayloadMessageEdited = {
12081
+ /**
12082
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12083
+ */
12066
12084
  id: string;
12067
12085
  event: 'message.edited';
12068
12086
  message: InboxWebhookMessage;
@@ -12091,7 +12109,7 @@ type event18 = 'message.edited';
12091
12109
  */
12092
12110
  type WebhookPayloadMessageSent = {
12093
12111
  /**
12094
- * Stable webhook event ID
12112
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12095
12113
  */
12096
12114
  id: string;
12097
12115
  event: 'message.sent';
@@ -12313,7 +12331,7 @@ type source3 = 'whatsapp_business_app' | 'cloud_api' | 'meta_business_agent';
12313
12331
  */
12314
12332
  type WebhookPayloadPhoneNumberStockAvailable = {
12315
12333
  /**
12316
- * Stable webhook event ID
12334
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12317
12335
  */
12318
12336
  id: string;
12319
12337
  event: 'phone_number.stock_available';
@@ -12355,7 +12373,7 @@ type event20 = 'phone_number.stock_available';
12355
12373
  */
12356
12374
  type WebhookPayloadPost = {
12357
12375
  /**
12358
- * Stable webhook event ID
12376
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12359
12377
  */
12360
12378
  id: string;
12361
12379
  event: 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
@@ -12375,6 +12393,14 @@ type WebhookPayloadPost = {
12375
12393
  platformPostId?: string;
12376
12394
  publishedUrl?: string;
12377
12395
  error?: string;
12396
+ /**
12397
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12398
+ */
12399
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12400
+ /**
12401
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
12402
+ */
12403
+ errorSource?: 'user' | 'platform' | 'system';
12378
12404
  platformError?: PostPlatformError;
12379
12405
  }>;
12380
12406
  /**
@@ -12412,7 +12438,7 @@ type event21 = 'post.scheduled' | 'post.published' | 'post.failed' | 'post.parti
12412
12438
  */
12413
12439
  type WebhookPayloadPostPlatform = {
12414
12440
  /**
12415
- * Stable webhook event ID.
12441
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12416
12442
  */
12417
12443
  id: string;
12418
12444
  event: 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
@@ -12438,6 +12464,14 @@ type WebhookPayloadPostPlatform = {
12438
12464
  platformPostId?: string;
12439
12465
  publishedUrl?: string;
12440
12466
  error?: string;
12467
+ /**
12468
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12469
+ */
12470
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12471
+ /**
12472
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
12473
+ */
12474
+ errorSource?: 'user' | 'platform' | 'system';
12441
12475
  platformError?: PostPlatformError;
12442
12476
  }>;
12443
12477
  /**
@@ -12471,6 +12505,14 @@ type WebhookPayloadPostPlatform = {
12471
12505
  * Error message from the platform. Present on `failed` only.
12472
12506
  */
12473
12507
  error?: string;
12508
+ /**
12509
+ * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
12510
+ */
12511
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
12512
+ /**
12513
+ * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
12514
+ */
12515
+ errorSource?: 'user' | 'platform' | 'system';
12474
12516
  /**
12475
12517
  * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
12476
12518
  */
@@ -12500,7 +12542,7 @@ type status20 = 'published' | 'failed' | 'deleted';
12500
12542
  */
12501
12543
  type WebhookPayloadReaction = {
12502
12544
  /**
12503
- * Stable webhook event ID
12545
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12504
12546
  */
12505
12547
  id: string;
12506
12548
  event: 'reaction.received';
@@ -12554,7 +12596,7 @@ type action = 'added' | 'removed';
12554
12596
  */
12555
12597
  type WebhookPayloadReferral = {
12556
12598
  /**
12557
- * Stable webhook event ID
12599
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12558
12600
  */
12559
12601
  id: string;
12560
12602
  event: 'referral.received';
@@ -12624,7 +12666,7 @@ type event24 = 'referral.received';
12624
12666
  */
12625
12667
  type WebhookPayloadReviewNew = {
12626
12668
  /**
12627
- * Stable webhook event ID
12669
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12628
12670
  */
12629
12671
  id: string;
12630
12672
  event: 'review.new';
@@ -12655,7 +12697,7 @@ type event25 = 'review.new';
12655
12697
  */
12656
12698
  type WebhookPayloadReviewUpdated = {
12657
12699
  /**
12658
- * Stable webhook event ID
12700
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12659
12701
  */
12660
12702
  id: string;
12661
12703
  event: 'review.updated';
@@ -12680,7 +12722,7 @@ type event26 = 'review.updated';
12680
12722
  */
12681
12723
  type WebhookPayloadTest = {
12682
12724
  /**
12683
- * Stable webhook event ID
12725
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12684
12726
  */
12685
12727
  id: string;
12686
12728
  event: 'webhook.test';
@@ -12706,7 +12748,7 @@ type event27 = 'webhook.test';
12706
12748
  */
12707
12749
  type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
12708
12750
  /**
12709
- * Stable webhook event ID
12751
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12710
12752
  */
12711
12753
  id: string;
12712
12754
  event: 'whatsapp.account.name_status_updated';
@@ -12755,7 +12797,7 @@ type status21 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
12755
12797
  */
12756
12798
  type WebhookPayloadWhatsAppTemplateCategoryUpdated = {
12757
12799
  /**
12758
- * Stable webhook event ID
12800
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12759
12801
  */
12760
12802
  id: string;
12761
12803
  event: 'whatsapp.template.category_updated';
@@ -12835,7 +12877,7 @@ type scheduledCategory = 'UTILITY' | 'MARKETING' | 'AUTHENTICATION';
12835
12877
  */
12836
12878
  type WebhookPayloadWhatsAppTemplateStatusUpdated = {
12837
12879
  /**
12838
- * Stable webhook event ID
12880
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
12839
12881
  */
12840
12882
  id: string;
12841
12883
  event: 'whatsapp.template.status_updated';
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.935",
39
+ version: "0.2.937",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.935",
8
+ version: "0.2.937",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.935",
3
+ "version": "0.2.937",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9210,7 +9210,7 @@ export type status18 = 'success' | 'failed';
9210
9210
  */
9211
9211
  export type WebhookPayloadAccountAdsInitialSyncCompleted = {
9212
9212
  /**
9213
- * Stable webhook event ID
9213
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9214
9214
  */
9215
9215
  id: string;
9216
9216
  event: 'account.ads.initial_sync_completed';
@@ -9335,7 +9335,7 @@ export type errorCategory2 = 'token_invalid' | 'permission_denied' | 'no_ad_acco
9335
9335
  */
9336
9336
  export type WebhookPayloadAccountConnected = {
9337
9337
  /**
9338
- * Stable webhook event ID
9338
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9339
9339
  */
9340
9340
  id: string;
9341
9341
  event: 'account.connected';
@@ -9365,7 +9365,7 @@ export type event2 = 'account.connected';
9365
9365
  */
9366
9366
  export type WebhookPayloadAccountDisconnected = {
9367
9367
  /**
9368
- * Stable webhook event ID
9368
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9369
9369
  */
9370
9370
  id: string;
9371
9371
  event: 'account.disconnected';
@@ -9417,7 +9417,7 @@ export type disconnectionType = 'intentional' | 'unintentional';
9417
9417
  */
9418
9418
  export type WebhookPayloadAdStatusChanged = {
9419
9419
  /**
9420
- * Stable webhook event ID
9420
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9421
9421
  */
9422
9422
  id: string;
9423
9423
  event: 'ad.status_changed';
@@ -9553,7 +9553,7 @@ export type level = 'CAMPAIGN' | 'AD_SET' | 'AD';
9553
9553
  */
9554
9554
  export type WebhookPayloadAnalyticsSynced = {
9555
9555
  /**
9556
- * Stable webhook event ID
9556
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9557
9557
  */
9558
9558
  id: string;
9559
9559
  event: 'analytics.synced';
@@ -9603,6 +9603,9 @@ export type event5 = 'analytics.synced';
9603
9603
  *
9604
9604
  */
9605
9605
  export type WebhookPayloadCallEnded = {
9606
+ /**
9607
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9608
+ */
9606
9609
  id: string;
9607
9610
  event: 'call.ended';
9608
9611
  call: {
@@ -9670,6 +9673,9 @@ export type event6 = 'call.ended';
9670
9673
  *
9671
9674
  */
9672
9675
  export type WebhookPayloadCallFailed = {
9676
+ /**
9677
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9678
+ */
9673
9679
  id: string;
9674
9680
  event: 'call.failed';
9675
9681
  call: {
@@ -9702,6 +9708,9 @@ export type event7 = 'call.failed';
9702
9708
  *
9703
9709
  */
9704
9710
  export type WebhookPayloadCallPermissionRequest = {
9711
+ /**
9712
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9713
+ */
9705
9714
  id: string;
9706
9715
  event: 'call.permission_request';
9707
9716
  permission: {
@@ -9739,7 +9748,7 @@ export type response = 'accept' | 'reject';
9739
9748
  */
9740
9749
  export type WebhookPayloadCallReceived = {
9741
9750
  /**
9742
- * Stable webhook event ID
9751
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9743
9752
  */
9744
9753
  id: string;
9745
9754
  event: 'call.received';
@@ -9788,7 +9797,7 @@ export type event9 = 'call.received';
9788
9797
  */
9789
9798
  export type WebhookPayloadComment = {
9790
9799
  /**
9791
- * Stable webhook event ID
9800
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9792
9801
  */
9793
9802
  id: string;
9794
9803
  event: 'comment.received';
@@ -9948,7 +9957,7 @@ export type platform12 = 'instagram' | 'facebook' | 'threads' | 'youtube' | 'lin
9948
9957
  */
9949
9958
  export type WebhookPayloadConversationControlChanged = {
9950
9959
  /**
9951
- * Stable webhook event ID
9960
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
9952
9961
  */
9953
9962
  id: string;
9954
9963
  event: 'conversation.control_changed';
@@ -9996,7 +10005,7 @@ export type previousOwner = 'app' | 'ai_agent' | 'other';
9996
10005
  */
9997
10006
  export type WebhookPayloadConversationStarted = {
9998
10007
  /**
9999
- * Stable webhook event ID
10008
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10000
10009
  */
10001
10010
  id: string;
10002
10011
  event: 'conversation.started';
@@ -10024,7 +10033,7 @@ export type event12 = 'conversation.started';
10024
10033
  */
10025
10034
  export type WebhookPayloadExternalPost = {
10026
10035
  /**
10027
- * Stable webhook event ID
10036
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10028
10037
  */
10029
10038
  id: string;
10030
10039
  event: 'post.external.created' | 'post.external.updated' | 'post.external.deleted';
@@ -10051,7 +10060,7 @@ export type event13 = 'post.external.created' | 'post.external.updated' | 'post.
10051
10060
  */
10052
10061
  export type WebhookPayloadLead = {
10053
10062
  /**
10054
- * Stable webhook event ID
10063
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10055
10064
  */
10056
10065
  id: string;
10057
10066
  event: 'lead.received';
@@ -10124,7 +10133,7 @@ export type platform13 = 'facebook';
10124
10133
  */
10125
10134
  export type WebhookPayloadMessage = {
10126
10135
  /**
10127
- * Stable webhook event ID
10136
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10128
10137
  */
10129
10138
  id: string;
10130
10139
  event: 'message.received';
@@ -10699,6 +10708,9 @@ export type contactsOrigin = 'contact_request' | 'other';
10699
10708
  *
10700
10709
  */
10701
10710
  export type WebhookPayloadMessageDeleted = {
10711
+ /**
10712
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10713
+ */
10702
10714
  id: string;
10703
10715
  event: 'message.deleted';
10704
10716
  message: InboxWebhookMessage;
@@ -10728,6 +10740,9 @@ export type event16 = 'message.deleted';
10728
10740
  *
10729
10741
  */
10730
10742
  export type WebhookPayloadMessageDeliveryStatus = {
10743
+ /**
10744
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10745
+ */
10731
10746
  id: string;
10732
10747
  event: 'message.delivered' | 'message.read' | 'message.failed';
10733
10748
  message: InboxWebhookMessage;
@@ -10780,6 +10795,9 @@ export type event17 = 'message.delivered' | 'message.read' | 'message.failed';
10780
10795
  *
10781
10796
  */
10782
10797
  export type WebhookPayloadMessageEdited = {
10798
+ /**
10799
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10800
+ */
10783
10801
  id: string;
10784
10802
  event: 'message.edited';
10785
10803
  message: InboxWebhookMessage;
@@ -10810,7 +10828,7 @@ export type event18 = 'message.edited';
10810
10828
  */
10811
10829
  export type WebhookPayloadMessageSent = {
10812
10830
  /**
10813
- * Stable webhook event ID
10831
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
10814
10832
  */
10815
10833
  id: string;
10816
10834
  event: 'message.sent';
@@ -11036,7 +11054,7 @@ export type source3 = 'whatsapp_business_app' | 'cloud_api' | 'meta_business_age
11036
11054
  */
11037
11055
  export type WebhookPayloadPhoneNumberStockAvailable = {
11038
11056
  /**
11039
- * Stable webhook event ID
11057
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11040
11058
  */
11041
11059
  id: string;
11042
11060
  event: 'phone_number.stock_available';
@@ -11080,7 +11098,7 @@ export type event20 = 'phone_number.stock_available';
11080
11098
  */
11081
11099
  export type WebhookPayloadPost = {
11082
11100
  /**
11083
- * Stable webhook event ID
11101
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11084
11102
  */
11085
11103
  id: string;
11086
11104
  event: 'post.scheduled' | 'post.published' | 'post.failed' | 'post.partial' | 'post.cancelled' | 'post.recycled';
@@ -11100,6 +11118,14 @@ export type WebhookPayloadPost = {
11100
11118
  platformPostId?: string;
11101
11119
  publishedUrl?: string;
11102
11120
  error?: string;
11121
+ /**
11122
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
11123
+ */
11124
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
11125
+ /**
11126
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
11127
+ */
11128
+ errorSource?: 'user' | 'platform' | 'system';
11103
11129
  platformError?: PostPlatformError;
11104
11130
  }>;
11105
11131
  /**
@@ -11139,7 +11165,7 @@ export type event21 = 'post.scheduled' | 'post.published' | 'post.failed' | 'pos
11139
11165
  */
11140
11166
  export type WebhookPayloadPostPlatform = {
11141
11167
  /**
11142
- * Stable webhook event ID.
11168
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11143
11169
  */
11144
11170
  id: string;
11145
11171
  event: 'post.platform.published' | 'post.platform.failed' | 'post.platform.deleted' | 'post.tiktok.url_resolved';
@@ -11165,6 +11191,14 @@ export type WebhookPayloadPostPlatform = {
11165
11191
  platformPostId?: string;
11166
11192
  publishedUrl?: string;
11167
11193
  error?: string;
11194
+ /**
11195
+ * Present when this target failed. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
11196
+ */
11197
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
11198
+ /**
11199
+ * Present when this target failed. Who must act: user, platform or system (Zernio).
11200
+ */
11201
+ errorSource?: 'user' | 'platform' | 'system';
11168
11202
  platformError?: PostPlatformError;
11169
11203
  }>;
11170
11204
  /**
@@ -11198,6 +11232,14 @@ export type WebhookPayloadPostPlatform = {
11198
11232
  * Error message from the platform. Present on `failed` only.
11199
11233
  */
11200
11234
  error?: string;
11235
+ /**
11236
+ * Error category for programmatic handling. Present on `failed` only. Same taxonomy as `platforms[].errorCategory` on GET /v1/posts.
11237
+ */
11238
+ errorCategory?: 'auth_expired' | 'user_content' | 'user_abuse' | 'account_issue' | 'platform_rejected' | 'platform_error' | 'platform_rate_limit' | 'quota_exhausted' | 'system_error' | 'unknown';
11239
+ /**
11240
+ * Who must act on the failure: user (fix content or reconnect), platform (outage or policy), system (Zernio). Present on `failed` only.
11241
+ */
11242
+ errorSource?: 'user' | 'platform' | 'system';
11201
11243
  /**
11202
11244
  * When the platform-side deletion was detected by Zernio sync (ISO 8601). Present only on `post.platform.deleted`.
11203
11245
  */
@@ -11230,7 +11272,7 @@ export type status20 = 'published' | 'failed' | 'deleted';
11230
11272
  */
11231
11273
  export type WebhookPayloadReaction = {
11232
11274
  /**
11233
- * Stable webhook event ID
11275
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11234
11276
  */
11235
11277
  id: string;
11236
11278
  event: 'reaction.received';
@@ -11287,7 +11329,7 @@ export type action = 'added' | 'removed';
11287
11329
  */
11288
11330
  export type WebhookPayloadReferral = {
11289
11331
  /**
11290
- * Stable webhook event ID
11332
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11291
11333
  */
11292
11334
  id: string;
11293
11335
  event: 'referral.received';
@@ -11359,7 +11401,7 @@ export type event24 = 'referral.received';
11359
11401
  */
11360
11402
  export type WebhookPayloadReviewNew = {
11361
11403
  /**
11362
- * Stable webhook event ID
11404
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11363
11405
  */
11364
11406
  id: string;
11365
11407
  event: 'review.new';
@@ -11392,7 +11434,7 @@ export type event25 = 'review.new';
11392
11434
  */
11393
11435
  export type WebhookPayloadReviewUpdated = {
11394
11436
  /**
11395
- * Stable webhook event ID
11437
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11396
11438
  */
11397
11439
  id: string;
11398
11440
  event: 'review.updated';
@@ -11419,7 +11461,7 @@ export type event26 = 'review.updated';
11419
11461
  */
11420
11462
  export type WebhookPayloadTest = {
11421
11463
  /**
11422
- * Stable webhook event ID
11464
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11423
11465
  */
11424
11466
  id: string;
11425
11467
  event: 'webhook.test';
@@ -11447,7 +11489,7 @@ export type event27 = 'webhook.test';
11447
11489
  */
11448
11490
  export type WebhookPayloadWhatsAppAccountNameStatusUpdated = {
11449
11491
  /**
11450
- * Stable webhook event ID
11492
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11451
11493
  */
11452
11494
  id: string;
11453
11495
  event: 'whatsapp.account.name_status_updated';
@@ -11500,7 +11542,7 @@ export type status21 = 'APPROVED' | 'DECLINED' | 'PENDING_REVIEW';
11500
11542
  */
11501
11543
  export type WebhookPayloadWhatsAppTemplateCategoryUpdated = {
11502
11544
  /**
11503
- * Stable webhook event ID
11545
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11504
11546
  */
11505
11547
  id: string;
11506
11548
  event: 'whatsapp.template.category_updated';
@@ -11586,7 +11628,7 @@ export type scheduledCategory = 'UTILITY' | 'MARKETING' | 'AUTHENTICATION';
11586
11628
  */
11587
11629
  export type WebhookPayloadWhatsAppTemplateStatusUpdated = {
11588
11630
  /**
11589
- * Stable webhook event ID
11631
+ * Stable webhook event ID: the dedupe key, also sent as the X-Zernio-Event-Id header and identical on every retry and redelivery. It identifies the event only, never an account or other resource.
11590
11632
  */
11591
11633
  id: string;
11592
11634
  event: 'whatsapp.template.status_updated';