Set trigger

PATCH

api

journeys

{journeyId}

trigger

Set trigger

curl --request PATCH \
  --url https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "segmentId": "<string>",
  "segmentName": "<string>",
  "eventName": "<string>",
  "inboundChannelIds": [
    "<string>"
  ],
  "inboundKeyword": "<string>",
  "maxEnrollments": 4503599627370496,
  "enrollmentWindow": "<string>"
}
'

import requests

url = "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger"

payload = {
    "segmentId": "<string>",
    "segmentName": "<string>",
    "eventName": "<string>",
    "inboundChannelIds": ["<string>"],
    "inboundKeyword": "<string>",
    "maxEnrollments": 4503599627370496,
    "enrollmentWindow": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    segmentId: '<string>',
    segmentName: '<string>',
    eventName: '<string>',
    inboundChannelIds: ['<string>'],
    inboundKeyword: '<string>',
    maxEnrollments: 4503599627370496,
    enrollmentWindow: '<string>'
  })
};

fetch('https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'segmentId' => '<string>',
    'segmentName' => '<string>',
    'eventName' => '<string>',
    'inboundChannelIds' => [
        '<string>'
    ],
    'inboundKeyword' => '<string>',
    'maxEnrollments' => 4503599627370496,
    'enrollmentWindow' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger"

	payload := strings.NewReader("{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "initiativeId": "<string>",
  "status": "DRAFT",
  "version": 0,
  "definition": {
    "name": "<string>",
    "actions": [
      {
        "id": "<string>",
        "kind": "ENTRY",
        "name": "<string>",
        "position": {
          "x": 123,
          "y": 123
        },
        "inputs": {
          "description": "<string>",
          "triggerType": "manual",
          "segmentId": "<string>",
          "segmentName": "<string>",
          "eventName": "<string>",
          "inboundAction": "WHATSAPP_MESSAGE",
          "inboundChannelIds": [
            "<string>"
          ],
          "inboundKeyword": "<string>",
          "inboundMatchMode": "EXACT",
          "maxEnrollments": 4503599627370496,
          "enrollmentWindow": "<string>"
        }
      }
    ],
    "edges": [
      {
        "from": "<string>",
        "to": "<string>",
        "sourceHandle": "<string>",
        "metadata": {
          "signalCategory": "lifecycle",
          "signalDescription": "<string>"
        }
      }
    ],
    "id": "<string>",
    "metadata": {
      "initiativeType": "<string>",
      "version": 0,
      "cancelOnEvents": {
        "eventNames": [
          "<string>"
        ]
      },
      "environmentId": "<string>"
    }
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Organization API key, sent as Authorization: Bearer boom_org_....

Path Parameters

journeyId

string

required

A draft journey id, or the initiative id (resolves to its current draft).

Minimum string length: 1

Body

application/json

triggerType

enum<string>

required

How people enter the journey.

Available options:

manual,

segment,

cdp_event,

inbound

segmentId

string

Required for segment triggers. The segment's id (from segments_list / segments_get) — NOT its slug.

segmentName

string

eventName

string

Required for cdp_event triggers.

inboundAction

enum<string>

Required for inbound triggers.

Available options:

WHATSAPP_MESSAGE,

SMS_MESSAGE,

INSTAGRAM_MESSAGE

inboundChannelIds

string[]

Required for inbound triggers: the channel ids to listen on. Must be NATIVE WhatsApp or SMS channels with an ONLINE sender; if you pass an ineligible one the error names the eligible ids. Several published journeys may share one channel as long as their keywords differ: publishing a rule whose keyword (or blank catch-all) is already taken on that channel is refused with INBOUND_CHANNEL_TAKEN. Each arriving message enrols exactly one of them, the most specific matching rule, ties going to the older initiative.

inboundKeyword

string

The word the inbound message must match for this journey to enrol — e.g. 'PRECIO'. Blank or absent means the trigger is the catch-all and fires on ANY message arriving on the channel, which is almost never what you want beside other journeys on the same number. Several journeys may share one channel as long as their keywords differ — two rules with the same keyword on one channel, or two blank ones, are refused at publish with INBOUND_CHANNEL_TAKEN. The keyword is matched accent-, case- and punctuation-insensitively, and stored normalized.

inboundMatchMode

enum<string>

How inboundKeyword is matched: EXACT (the message is only-the-word), ALL_WORDS (the message contains all-the-words, in any order), or CONTAINS (the message contains-the-word, adjacent and in order). All three are word-based, so no mode ever matches inside a longer word ('precioso' does not match 'precio'). Defaults to EXACT. Ignored when inboundKeyword is blank.

Available options:

EXACT,

CONTAINS,

ALL_WORDS

maxEnrollments

integer

Frequency cap; both-or-neither with enrollmentWindow.

Required range: 1 <= x <= 9007199254740991

enrollmentWindow

string

Frequency-cap window, e.g. '7d'.

Response

Success

string

required

Journey (workflow version) id.

initiativeId

string

required

The initiative this journey belongs to.

status

enum<string>

required

DRAFT (editable), PUBLISHED (live, frozen), or STOPPED (retired).

Available options:

DRAFT,

PUBLISHED,

STOPPED

version

integer

required

Version number within the initiative.

Required range: -9007199254740991 <= x <= 9007199254740991

definition

object

required

The full journey graph.

Show child attributes

Set trigger

curl --request PATCH \
  --url https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "segmentId": "<string>",
  "segmentName": "<string>",
  "eventName": "<string>",
  "inboundChannelIds": [
    "<string>"
  ],
  "inboundKeyword": "<string>",
  "maxEnrollments": 4503599627370496,
  "enrollmentWindow": "<string>"
}
'

import requests

url = "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger"

payload = {
    "segmentId": "<string>",
    "segmentName": "<string>",
    "eventName": "<string>",
    "inboundChannelIds": ["<string>"],
    "inboundKeyword": "<string>",
    "maxEnrollments": 4503599627370496,
    "enrollmentWindow": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    segmentId: '<string>',
    segmentName: '<string>',
    eventName: '<string>',
    inboundChannelIds: ['<string>'],
    inboundKeyword: '<string>',
    maxEnrollments: 4503599627370496,
    enrollmentWindow: '<string>'
  })
};

fetch('https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'segmentId' => '<string>',
    'segmentName' => '<string>',
    'eventName' => '<string>',
    'inboundChannelIds' => [
        '<string>'
    ],
    'inboundKeyword' => '<string>',
    'maxEnrollments' => 4503599627370496,
    'enrollmentWindow' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger"

	payload := strings.NewReader("{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.useboom.ai/api/v1/journeys/{journeyId}/trigger")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"segmentId\": \"<string>\",\n  \"segmentName\": \"<string>\",\n  \"eventName\": \"<string>\",\n  \"inboundChannelIds\": [\n    \"<string>\"\n  ],\n  \"inboundKeyword\": \"<string>\",\n  \"maxEnrollments\": 4503599627370496,\n  \"enrollmentWindow\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "initiativeId": "<string>",
  "status": "DRAFT",
  "version": 0,
  "definition": {
    "name": "<string>",
    "actions": [
      {
        "id": "<string>",
        "kind": "ENTRY",
        "name": "<string>",
        "position": {
          "x": 123,
          "y": 123
        },
        "inputs": {
          "description": "<string>",
          "triggerType": "manual",
          "segmentId": "<string>",
          "segmentName": "<string>",
          "eventName": "<string>",
          "inboundAction": "WHATSAPP_MESSAGE",
          "inboundChannelIds": [
            "<string>"
          ],
          "inboundKeyword": "<string>",
          "inboundMatchMode": "EXACT",
          "maxEnrollments": 4503599627370496,
          "enrollmentWindow": "<string>"
        }
      }
    ],
    "edges": [
      {
        "from": "<string>",
        "to": "<string>",
        "sourceHandle": "<string>",
        "metadata": {
          "signalCategory": "lifecycle",
          "signalDescription": "<string>"
        }
      }
    ],
    "id": "<string>",
    "metadata": {
      "initiativeType": "<string>",
      "version": 0,
      "cancelOnEvents": {
        "eventNames": [
          "<string>"
        ]
      },
      "environmentId": "<string>"
    }
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Overview

Initiatives

Journeys

Segments

WhatsApp

Set trigger

Authorizations

Path Parameters

Body

Response