Sign inGet Started
Inizia ora
Guide
Riferimento API
SDK
CLI
Knowledge Base
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);
Risposta200
{
  "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.
Parametri di query
business_id
string
Keep only routing rules belonging to this business. Omit to return rules across all businesses in the workspace.
Payload di risposta
data
array of object
obbligatorio
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.
Mostra attributi secondari
data.created_at
string
obbligatorio
data.updated_at
string
obbligatorio
data.id
string
obbligatorio
Unique identifier for the routing rule.
data.business_id
string
obbligatorio
The Apple Messages for Business brand this rule belongs to.
data.match_kind
string
obbligatorio
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
obbligatorio
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
obbligatorio
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
obbligatorio
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.

Risorse correlate

Prosegui con la documentazione, le guide e gli esempi per questo argomento. Le risorse sono in inglese.

Comprendi il concettoShould I use a Bird SDK or call the API directly?Segui il percorso di apprendimentoBuild your first integrationGuida all'implementazioneSend your first email
Ottieni un brief di implementazione