Kehittäjille ja agenteille

Liitä agenttisi ja järjestelmäsi OperationsLensiin.

MCP-liittimen kautta tekoälyagentti käsittelee tikettejä tiimisi jäsenenä. REST-rajapinnan kautta omat järjestelmäsi lukevat tikettejä ja asiakkaita ja luovat uusia tikettejä.

01 · MCP-liitin

Tekoälyagenteille: MCP-liitin

Etä-MCP-palvelin, johon voi liittyä mikä tahansa MCP-asiakasohjelma, joka tukee etäpalvelimia ja OAuth-kirjautumista. Agentti kirjautuu tiimisi jäsenenä ja toimii täsmälleen tämän jäsenen roolilla ja käyttöoikeuksilla, samoin säännöin kuin OperationsLens-sovelluksessa.

Palvelimen osoite

https://app.operationslens.ai/mcp

Käyttöönotto

  1. Lisää palvelimen osoite MCP-asiakasohjelmaasi etäpalvelimeksi (mukautettu liitin).
  2. Kirjaudu OperationsLens-tunnuksillasi ja valitse organisaatio, jonka liität.
  3. Hyväksy lukuoikeus tai luku- ja kirjoitusoikeus.

Hyvä tietää

  • Kirjoittavilla työkaluilla on todellisia vaikutuksia: vastaus lähtee asiakkaalle sähköpostina samoin kuin tiimisi lähettäessä sen sovelluksesta.
  • Asiakkaiden kirjoittama teksti merkitään työkalujen tuloksissa asiakasdataksi, jotta agentti erottaa sen ohjeista.
  • Enintään 120 pyyntöä minuutissa yhteyttä kohden.

Työkalut

  • whoami Luku

    Organisaatiosi, roolisi ja yritykset, joissa voit työskennellä

  • list_members Luku

    Tiimiläisesi tikettien osoittamista varten

  • search_tickets Luku

    Hae tikettejä tekstillä, tilalla, prioriteetilla, vastuuhenkilöllä tai yrityksellä

  • get_ticket Luku

    Yksi tiketti ja sen uusimmat viestit

  • create_ticket Kirjoitus

    Avaa tiketti ja lähetä se halutessasi asiakkaalle sähköpostina

  • reply_to_customer Kirjoitus

    Vastaa asiakkaalle sähköpostilla tai portaalissa

  • add_internal_note Kirjoitus

    Lisää muistiinpano, jonka vain tiimisi näkee

  • update_ticket Kirjoitus

    Muuta tilaa, prioriteettia tai vastuuhenkilöä. Kun tiketti merkitään ratkaistuksi, asiakas saa tyytyväisyyskyselyn

02 · REST-rajapinta

Omille järjestelmillesi: REST-rajapinta

Palvelinten välinen yhteys omille järjestelmillesi: lue tikettejä ja asiakkaita, luo tikettejä, lisää viestejä ja hae ratkaisutilastoja. Pyynnöt tunnistetaan organisaation API-avaimella.

Tiimimme myöntää API-avaimet pyynnöstä. Avaimella on lukuoikeus, kirjoitusoikeus tai molemmat, sille voi asettaa vanhenemispäivän, ja sen voi rajata yhteen yritykseen.

Päätepisteet

  • GET /api/v1/tickets Luku

    Listaa tiketit uusimmasta alkaen, halutessasi tilan mukaan suodatettuna

  • GET /api/v1/tickets/:id Luku

    Yksi tiketti viesteineen ja tunnisteineen

  • POST /api/v1/tickets Kirjoitus

    Luo tiketti. Asiakas haetaan, tai luodaan, sähköpostiosoitteen perusteella

  • POST /api/v1/tickets/:id/messages Kirjoitus

    Lisää tikettiin viesti tai sisäinen muistiinpano

  • GET /api/v1/customers Luku

    Listaa asiakkaat viimeksi aktiivisesta alkaen

  • GET /api/v1/customers/:id Luku

    Yksi asiakas ja hänen uusimmat tikettinsä

  • GET /api/v1/analytics/resolutions Luku

    Ratkaisutilastot valitulta aikaväliltä

Tunnistautuminen

Authorization: Bearer sl_live_…

Esimerkki: tiketin luonti

curl -X POST https://app.operationslens.ai/api/v1/tickets \
  -H "Authorization: Bearer $OPERATIONSLENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subject":"Order 4411 arrived damaged","customerEmail":"ana@example.com","content":"Two of six boxes crushed."}'

Hyvä tietää

  • Enintään 100 pyyntöä minuutissa avainta kohden. Jokainen vastaus kertoo jäljellä olevan kiintiön X-RateLimit-*-otsakkeissa.
  • Onnistunut vastaus palauttaa tuloksen data-kentässä, ja listoissa sivutustiedot ovat meta-kentässä. Virhe palauttaa kentät error ja message.
  • Idempotenssiavainta ei ole: tiketin luovan pyynnön uusiminen luo toisen tiketin.

Mitä nyt on saatavilla

Tällä hetkellä MCP-liitin ja REST-rajapinta käsittelevät tikettejä ja asiakkaita eli OperationsLensin Customer Desk -puolta.

Kehitämme niitä jatkuvasti. Jos haluaisit liittää jotain, mitä täältä ei vielä löydy, esimerkiksi Order Intake- tai Invoice Check -tietoja, kerro meille: palautteesi vaikuttaa siihen, mitä rakennamme seuraavaksi.

Rakennatko integraatiota, tarvitsetko API-avaimen tai puuttuuko jotain?

Ota yhteyttä