---
sourceDocument: Australia Customer Service Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/customer-service-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Customer Service Management

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# Invoke the MatchingRuleProcessor API

# Invoke the MatchingRuleProcessor API {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

After you create one or more matching rules, you can invoke the MatchingRuleProcessor
API and run the rules.

## Antes de Iniciar

Role required: sn_customerservice_agent, sn_customerservice_manager, admin

## Procedimento

* You can invoke the matching engine using the processAndGetCandidates method of the matchingRuleProcessor class.  
  Pass in the task record and the number of resources. The result is an array of resource sys_ids.
* The system processes the matching rules based on the number stored in the Execution Order field for each rule.  
  The result is a list of users (sys_ids), which you can use for case routing and assignment.
{#t_InvokeMatchingRuleAPI__steps-unordered_j5x_qmj_nsb}