Sign inGet Started
Mulai sekarang
Panduan
Referensi API
SDK
CLI
Basis Pengetahuan
Changelog

List Apple Messages for Business routing rules

GET
/v1/amb/routing-rules
const result = await bird.amb.routingRules.list({
  business_id: "abz_01krdgeqcxet5s7t44vh8rt9mg",
});
console.log(result);
Respons200
{
  "data": [
    {
      "created_at": "2026-05-20T09:14:52Z",
      "updated_at": "2026-05-25T16:42:01Z",
      "id": "arr_01krdgeqcxet5s7t44vh8rt9mg",
      "business_id": "abz_01krdgeqcxet5s7t44vh8rt9mg",
      "match_kind": "intent",
      "match_intent_id": "order_status",
      "match_group_id": "support",
      "queue": "billing",
      "precedence": 10,
      "is_default": false
    }
  ]
}
Returns the workspace's Apple Messages for Business routing rules, highest precedence first. A rule only runs when a conversation is created or reopened, matching it to a queue based on the group and intent its entry point carried. It never runs again while the conversation stays open, so a queue an operator moves a conversation to is not overwritten by the next message the customer sends.
Parameter Kueri
business_id
string
Keep only routing rules belonging to this business. Omit to return rules across all businesses in the workspace.
Payload Respons
data
array of object
wajib
The workspace's routing rules, optionally filtered by business, highest precedence first and ties broken by id. Rules are evaluated within their business in this order. The set is returned in full; this list is not paginated.
Tampilkan atribut turunan
data.created_at
string
wajib
data.updated_at
string
wajib
data.id
string
wajib
Unique identifier for the routing rule.
data.business_id
string
wajib
The Apple Messages for Business brand this rule belongs to.
data.match_kind
string
wajib
What a routing rule matches against the entry point that started the conversation.
  • intent matches on the entry point's intent alone: match_intent_id is set and match_group_id is null.
  • group matches on the entry point's group alone: match_group_id is set and match_intent_id is null.
  • both matches only when the entry point carries the given intent and the given group together, so match_intent_id and match_group_id are both set. There are two match fields rather than one because both needs to carry an intent and a group at once.
Possible values: intent, group, both
data.match_intent_id
nullable string
The entry point intent this rule matches, as sent in Apple's intentID. Set when match_kind is intent or both, null when it is group.
data.match_group_id
nullable string
The entry point group this rule matches, as sent in Apple's groupID. Set when match_kind is group or both, null when it is intent.
data.queue
string
wajib
The queue a matching conversation is filed into. A queue is a label your console filters by rather than a resource you create ahead of time, so any value routes.
data.precedence
integer
wajib
Evaluation order among this business's rules. The highest-precedence rule a conversation matches wins; rules tied on precedence are evaluated by their id.
data.is_default
boolean
wajib
Whether this rule catches a conversation that matches nothing else. A business has at most one. A conversation created or reopened while none exists routes to an empty queue, which the console lists as unrouted.

Sumber daya terkait

Lanjutkan dengan dokumentasi, panduan, dan contoh untuk topik ini. Sumber daya tersedia dalam bahasa Inggris.

Pahami konsepnyaShould I use a Bird SDK or call the API directly?Ikuti jalur pembelajaranBuild your first integrationPanduan implementasiSend your first email
Dapatkan ringkasan implementasi