---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# API für Agent-Zuordnung

# API für Agent-Zuordnung {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 10. Februar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die Agent-Zuordnung Die API stellt einen Endpunkt bereit, um externe Agenten-IDs aus CCaaS-Systemen (Contact Center as a Service) internen Agenten-IDs in zuzuordnen Now Platform.
Diese API erfordert das Plugin „Verwaltung externer Agenten" (sn_external_Agent). Um diese API aufzurufen, müssen Sie über die Rolle Interaction_Agent verfügen.

Weitere Informationen zur Integration in CCaaS-Systeme finden Sie unter [Integrating with contact centers](https://www.servicenow.com/docs/access?context=contactcenter-integration&version=yokohama&pubname=yokohama-customer-service-management&ft:locale=en-US).

## Agent-Zuordnung -- PUT /sn_ct_ctr_it_core/Agent_Mapping/Agent/{AGENTID}/inborder Id/{inborder Id} {#ariaid-title2}

Ordnet eine externe Agenten-ID aus einem Contact Center-as-a-Service-System (CCaaS) einer internen Agenten-ID in zu Now Platform.
Rufen Sie diesen Endpunkt auf, wenn sich ein Agent beim CCaaS-System anmeldet oder abmeldet, um seinen aktiven Status zu aktualisieren. Dieser Endpunkt erstellt oder aktualisiert Datensätze in der Tabelle „Zuordnung externer Agenten" \[external_Agent_Mapping\] mit den folgenden Daten:

* ID des externen CCaaS-Agenten
* Identität des Anbieterkanals, der der eingehenden ID zugeordnet ist
* Aktiver Status des Agenten im CCaaS-System
* Verweis auf den Anwenderdatensatz \[sys_user\] für den Service Desk-Mitarbeiter
{#agent-mapping-PUT-agent-inid__ul_ljy_ytt_32c}

### URL-Format

Standard-URL: /api/sn_ct_ctr_it_core/Agent_Mapping/Agent/{AGENTID}/inlimitId/{inlimitId}

### Unterstützte Anforderungsparameter

{#agent-mapping-PUT-agent-inid__entry__2}

| Name | Beschreibung |
|-|-|
| agentId | SYS_ID des internen Agenten. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| eingehendeId | Eingehende ID aus dem Identitätsdatensatz des Anbieterkanals für das CCaaS-System. Datentyp: Zeichenfolge Tabelle: Identität des Anbieterkanals \[sys_cs_provider_application\] Feld: Eingehende ID |
[Tabelle : 1. Pfad-Parameter]

{#agent-mapping-PUT-agent-inid__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#agent-mapping-PUT-agent-inid__entry__12}

| Name | Beschreibung |
|-|-|
| aktiv | Kennzeichnung, die angibt, ob der Agent derzeit beim CCaaS-System angemeldet ist. Gültige Werte: * Wahr: Der Agent ist angemeldet. * Falsch: Der Agent ist abgemeldet. {#agent-mapping-PUT-agent-inid__ul_qhf_vst_32c} Standard: Wahr Datentyp: Boolescher Wert |
| External_Agent_ID | Erforderlich. ID des externen Agenten aus dem CCaaS-System. Datentyp: Zeichenfolge |
[Tabelle : 3. Anforderungstext-Parameter (JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#agent-mapping-PUT-agent-inid__entry__18}{#agent-mapping-PUT-agent-inid__accept-JSON-only-entry-RESTAPI}{#agent-mapping-PUT-agent-inid__content_type-JSON-only-entry-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Nur unterstützt application/json. |
| Inhaltstyp | Datenformat des Anforderungstexts. Nur unterstützt application/json. |
[Tabelle : 4. Anforderungskopfzeilen.]

{#agent-mapping-PUT-agent-inid__entry__24}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#agent-mapping-PUT-agent-inid__entry__28}

| Statuscode | Beschreibung |
|-|-|
| 200 | OK. Vorhandener Agent-Zuordnungsdatensatz aktualisiert. |
| 201 | Erstellt. Neuer Agent-Zuordnungsdatensatz erstellt. |
| 400 | Ungültige Anforderung. Die in der Anforderung angegebene Agent-ID oder eingehende ID ist ungültig. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON)

{#agent-mapping-PUT-agent-inid__entry__36}

| Name | Beschreibung |
|-|-|
| Ergebnis | Ergebnisobjekt mit Informationen zur Anforderung. Datentyp: Objekt |
| Ergebnis.Zuordnungs-IDs | SYS_IDs aller erstellten oder aktualisierten Datensätze in der Tabelle „Zuordnung externer Agenten" \[external_Agent_Mapping\]. Datentyp: Array von Zeichenfolgen |
| Ergebnis.Nachricht | Nachricht, die das Ergebnis der Anforderung erklärt. Datentyp: Zeichenfolge |
| Ergebnis.Status | Status der Anforderung. Mögliche Werte: * Erfolg * Fehler {#agent-mapping-PUT-agent-inid__ul_kqs_m5m_32c} Datentyp: Zeichenfolge |
[ ]

### Curl-Anforderung

Dieses Beispiel ordnet einen internen Agenten sys_ID zu `Da419c1fc312310015519f2974d3ae15 `An die entsprechende ID `12345 `Aus dem externen CCaaS-System.

    curl "https://instance.service-now.com/api/sn_ct_ctr_it_core/agent_mapping/agent/da419c1fc312310015519f2974d3ae15/inboundId/ServiceNowVoice" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"external_agent_id\":\"12345\"}" \ 
    --user 'username':'password'

Antworttext:

    {
      "result": { 
        "message": "Agent Id mapping record inserted", 
        "status": "success", 
        "mappingIds": [ 
          "128b74fcc3931a50325a4ad9d00131c3" 
        ] 
      } 
    }

### Curl-Anforderung {#agent-mapping-PUT-agent-inid__example_izk_k5t_32c}

Dieses Beispiel legt fest activeParameter bis `Falsch `Gibt an, dass der Agent vom CCaaS-System abgemeldet ist.

    curl "https://instance.service-now.com/api/sn_ct_ctr_it_core/agent_mapping/agent/da419c1fc312310015519f2974d3ae15/inboundId/ServiceNowVoice" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{"external_agent_id":"12345", "active":"false"}" \ 
    --user 'username':'password'

Antworttext:

    { 
      "result": { 
        "message": "Agent Id mapping record updated", 
        "status": "success", 
        "mappingIds": [ 
          "cea77cebebef9e10a341fc7acad0cdc2" 
        ] 
      } 
    }


