דלג לתוכן הראשי
Subscribe to receive a notification when a chat subscribes or opts back in to template messages - manually in Texter or via the Resubscribe to Templates endpoint. Event name: chatSubscribed\ Required token scopes:
  • Create scenarios
  • Manage scenarios on behalf of user
see Authentication

Subscribe

Send the body below to Import Subscription. You only need to change:
  • url (required) - Located under data.actions[0].params.url. Replace {{yourWebhookURL}} with the destination URL that should receive the events.
  • asStatus - Keep "active" to enable the subscription immediately, or "inactive" to save it as an inactive revision.
Import body
{
  "data": {
    "version": "v1",
    "name": "(SUB) Chat Subscribed",
    "description": "Sends a webhook when a chat subscribes or opts back in to receiving template messages.",
    "triggerEvents": [
      "domain.chat.subscribed"
    ],
    "loaders": {},
    "conditions": [],
    "actions": [
      {
        "name": "request",
        "params": {
          "url": "{{yourWebhookURL}}",
          "method": "post",
          "json": true,
          "data": {
            "eventName": "chatSubscribed",
            "eventData": {
              "chat": {
                "##provide": {
                  "provider": "chat",
                  "key": "chat"
                }
              }
            }
          }
        },
        "confidentialData": false
      }
    ],
    "options": {
      "unorderedActions": false
    }
  },
  "asStatus": "active"
}
A 201 response returns your new subscription - save its _id to manage it later. You can also add an optional authorUid root field (a Texter user UID) to attribute the subscription to a specific user.

Payload

When the event fires, your URL receives an HTTP POST with eventName: "chatSubscribed" and the following eventData:
chat
Chat
The chat that subscribed. See the Chat object for all fields.
Example payload
{
  "eventName": "chatSubscribed",
  "eventData": {
    "chat": {
      "_id": "69062b15262e17ab3033f886",
      "title": "Tyler Joseph",
      "...": "..."
    }
  }
}

Manage this subscription