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);result = client.amb.routing_rules.list(business_id='abz_01krdgeqcxet5s7t44vh8rt9mg')
print(result)result, err := client.Amb.RoutingRules.List(ctx, bird.AmbRoutingRulesListParams{BusinessID: "abz_01krdgeqcxet5s7t44vh8rt9mg"})
if err != nil {
log.Fatal(err)
}
fmt.Println(result)$rules = $bird->amb->routingRules->list(['business_id' => 'abz_01krdgeqcxet5s7t44vh8rt9mg']);
var_dump($rules->getData());bird amb routing-rules listcurl -X GET "https://us1.platform.bird.com/v1/amb/routing-rules" \
-H "Authorization: Bearer $TOKEN"响应200
{
"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.
查询参数
business_id
string
Keep only routing rules belonging to this business. Omit to return rules across all businesses in the workspace.
响应载荷
data
array of object
必填
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.
显示子属性
data.created_at
string
必填
data.updated_at
string
必填
data.id
string
必填
Unique identifier for the routing rule.
data.business_id
string
必填
The Apple Messages for Business brand this rule belongs to.
data.match_kind
string
必填
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
必填
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
必填
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
必填
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.