Voorbeelden van door Cisco ontwikkeld bots in gebruik.

Bots in Webex-app

BELANGRIJK: Cisco Webex kondigt beëindiging aan van de notie bot-integratie met de Webex-app. Deze bot wordt niet meer ondersteund en er zijn geen nieuwe installaties mogelijk na 31 maart 2024. Als u de bot in een ruimte hebt toegevoegd of een 1-1 actief hebt met de notie-bot, moet deze blijven werken tot 30 juni 2024. Plaats dit de bot zal stoppen met werken. Als u zelf een vergelijkbare integratie wilt bouwen, kunt u onze Webex-botdocumentatie bekijken op https://developer.webex.com/docs/bots.

Voorbeelden van door Cisco ontwikkeld bots in gebruik.

Bots kunnen helpen om de functionaliteit van de Webex-app uit te breiden naar een app van derden. U kunt bots toevoegen aan Ruimten van de Webex-app en rechtstreeks met de app van derden communiceren vanuit de ruimte. Wanneer u de bot aan de ruimte hebt toegevoegd, kunt u een help-bericht naar de bot verzenden en het antwoord bevat de opdrachten die de bot ondersteunt.

U kunt een bot toevoegen aan elk type ruimte; Voeg een bot toe aan uw projectruimte met andere personen en werk rechtstreeks met de app van derden uit uw ruimte. Of u kunt een ruimte maken voor alleen u en de bot voor interactie met de app van derden.

Webex App Hub bevat een catalogus van bots en apps die zijn ontwikkeld door Cisco en externe ontwikkelaars.

Kaarten in Webex-app

Bots presenteren informatie op verschillende manieren binnen de Webex-app. Bot-kaarten maken het eenvoudiger voor gebruikers om rechtstreeks met de bot te communiceren respons op een opdracht. U kunt kiezen uit vervolgkeuzemenu's, knoppen gebruiken en zelfs tekstvelden gebruiken om informatie bij te werken en te verzamelen.

Zie Knoppen en kaarten voor uw Webex-apps.

Rapporteer alle problemen op de bot met kaarten aan devsupport@webex.com.

Als uw beheerder de bot voor niet-beheerders in uw organisatie heeft ingeschakeld, kunt u de ServiceNow-bot toevoegen en gebruiken in een ruimte van de Webex-app.

ServiceNow-bot toevoegen

Voordat u begint

Uw ServiceNow-beheerder moet bot-toegang toestaan, zoals beschreven in het tabblad Beheerders, voordat u met de bot kunt communiceren.

1

Selecteer > Rechtstreeks bericht verzenden op de Webex-app-balk.

2

Typ @ServiceNow om te zoeken naar de bot.

3

Kies ServiceNow-bot in de lijst om een ruimte te openen.

De volgende stap

De bot maakt een ruimte met een welkomstkaart en een knop Koppeling ServiceNow-account . Als u ServiceNow-beheerder bent, klikt u op de knop en voltooit u het installatieproces voor de bot zoals uitgelegd in het tabblad Beheer.

Als u geen beheerder bent, vraagt u uw ServiceNow-beheerder om het bot-installatieproces voor niet-beheerdersgebruikers te voltooien om met de bot te communiceren.

Een incident melden

Maak een incident in ServiceNow vanuit een ruimte.

1

Typ help in de ServiceNow-botruimte en verzend het bericht.

2

Selecteer Incident melden en voer de naam in van de persoon die het probleem heeft gemeld. Klik vervolgens op Zoeken naar de beller.

3

Voer de beschrijving, incidenttoestand en meldingen in en selecteer incident verzenden.

Zoeken naar een incident

Zoek een incident met het incidentnummer of de datum die is gemaakt.

1

Typ help in de ServiceNow-botruimte en kies Incident ophalen op de kaart.

  • Recente cijfers: kies Uit recente cijfers om de lijst met onlangs geopende incidenten weer te zien.
  • Op incidentnummer: kies Zoeken in incident om het incidentnummer in te voeren.
2

Selecteer Nogmaals Incident op halen om incidentgegevens weer te geven.

Incidenten bijwerken en oplossen

Gebruik de bot-kaart om incidenten bij te werken of op te lossen.

1

Typ help in de ServiceNow-botruimte en verzend het bericht.

2

Zoek naar het incident dat u wilt beheren.

3

Kies in de kaart met incidentgegevens :

  • Bijwerken: de beschrijving en status van het incident wijzigen. Klik op Weergeven in ServiceNow om andere gegevens bij te werken.
  • Markeren als opgelost: om de resolutiecode op te geven en resolutieopmerkingen toe te voegen.
Uw aantekeningen zijn zichtbaar in de ServiceNow-app.

Verbind de Webex-app met ServiceNow en configureer vervolgens botinstellingen en -toestemmingen om bottoegang toe te staan voor niet-beheerdersgebruikers.

De bot toevoegen

Maak eerst een ruimte met de ServiceNow-bot om uw account te koppelen. Als u een firewall gebruikt of toegang tot uw domein beperkt, moet u deze IP-adressen toestaan.

1

Selecteer in de koptekst van de app > Een direct bericht verzenden.

2

Voer de botnaam ServiceNow.bot@webex.bot in en maak de ruimte.

3

Voer help in en verzend het bericht.

4

Selecteer Koppeling ServiceNow-account in de bot-kaart.

5

Voer op de instelwebpagina uw ServiceNow-domein in (exclusief:.service-now.com).

6

Open een ander browservenster om de installatiestappen voor de beheerder in Service Management te voltooien.

Beide vensters open houden tijdens de installatie.
Installatie beheerder

Een gebruikersprofiel voor integratie maken

Maak vervolgens een profiel dat toestemmingen voor interactie met de bot van toepassing is op alle niet-beheerdersgebruikers in uw organisatie.

  1. Meld u aan bij uw ServiceNow-beheerdersaccount en zoek naar Gebruikers in de Filternavigator.

  2. Selecteer onderOrganisatie de optie Gebruikers > nieuw.

  3. VoegIntegration_Usertoe aan het veld Gebruikers-id, stel een wachtwoord in en selecteer vervolgens het vak Gebruiker interne integratie en Verzenden.

  4. Selecteer in de lijst met gebruikers het Gebruikersprofielntegration_ en selecteer vervolgens het tabblad Rollen onderaan de pagina.

  5. Klik op Bewerken en selecteer Beheerder in de lijst met verzamelingen en klik vervolgens op Toevoegen en opslaan.

  6. Selecteer Bijwerken bovenaan gebruikersprofiel pagina.

  7. Klik op de instellingspagina onder aan de pagina Verbinden met ServiceNow op Valideren.

Het domein instellen

Registreer het IUser-profielntegration_ en pas bot-instellingen toe.

  1. Meld u vanuit uw ServiceNow-toepassing af bij uw beheerdersaccount en meld u aan alsIntegration_User met het wachtwoord dat u eerder hebt gemaakt.

  2. Selecteer op de instellingspagina Aangemeld bij Integratie gebruikersaccounten ga door naar Beheer instellen.

  3. Voordat u de client-id en het geheim toevoegt, kopieert u de omleidings-URLen gaat u terug naar uw ServiceNow-toepassing.

  4. Zoek naar het toepassingsregisterin het Filternavigatie en selecteer Toepassingsregister.

  5. Klik op Nieuwe > een OAuth API-eindpunt voor externe clients maken.

  6. Voer App Webex-service nu in voor de toepassingsnaam en klik op Ontgrendelen om de omleidings-URL te plakken die vanuit het instellingenvenster is gekopieerd.

  7. Klik op de instelwebpagina op Hoe vind ik mijn ServiceNow-client-id, geheime en omleidings-URL, scrol omlaag naar stap 4 en kopieer de logo-URL.

  8. In uw ServiceNow-toepassing, klikt u op ontgrendelen om de Logo-URL te plakkenen vervolgens Verzenden .

  9. Selecteer webex-service app uit de lijst, kopieer de client-id en klik vervolgens op ontgrendelen om het client geheim te kopiëren.

  10. Voeg de client-id en het client geheim toe in het configuratievenster. Klik vervolgens op Doorgaan en toestaan om nu verbinding webex-service maken met de app met uw account.

  11. Kies de verplichte velden om een incident op te vragen en klik vervolgens op Doorgaan.

Bot configureren en toestemmingen toepassen

Koppel de e-mail-id en de domeinnaam om toegang voor alle niet-beheerdersgebruikers toe te staan. Configureer vervolgens de bot-aanvraag en responsparameters en pas gegevenstoegangsrechten toe.

  1. Zoek vanuit uw ServiceNow-toepassing naargescripteerde rest-API'sin Filternavigatie en selecteer vervolgens Gescripteerde REST API's.

  2. Klik op Nieuw, voeg Webex-gescripte API toe als de naam, kopieer en plak deze in het veld API-id en klik vervolgens op Verzenden.

  3. Klik in de lijst Gescripteerde REST API's op de Webex-gescripteerde APIen selecteer het tabblad Resources onder aan de pagina.

  4. Klik op Nieuw, voeg Webex-gescripte APItoe als de resourcenaam en wijzig de HTTP-methode naar POST.

  5. Kopieer het script vanuit hoe ik de instructies voor mijn ServiceNow-client-id, geheim en omleidings-URL vind, scrol omlaag naar stap 6 en kopieer en plak het script in het scriptveld .

    Zorg dat u bestaande tekst vervangt en klik op Verzenden.

  6. Kopieer het Basis API-pad linksboven in gebruikersprofiel klik vervolgens op Bijwerken.

  7. Voeg op de instellingspagina uw e-mail-id van de ServiceNow-beheerder toe en plak het Base API-pad. Klik vervolgens op het venster Opslaan en sluiten.

Configuratie voltooien

Wanneer u klaar bent met het instellen van het Integration_Gebruiker -profiel, beperkt u de toegang tot de webservice alleen om wijzigingen in de instellingen te voorkomen.

  1. Zoek in uw ServiceNow-toepassing naar Gebruikersin de Filternavigator.

  2. Selecteer het nieuwe gebruikersprofiel in de gebruikerslijst en klik op Bewerken.

  3. Schakel het selectievakje Alleen toegang voor webservice in en klik vervolgens op Bijwerken en afmelden bij Servicebeheer.

Problemen oplossen

Foutbericht: Kan de gevraagde actie niet uitvoeren omdat de opgegeven e-mail-id niet is geregistreerd als een gebruiker in de ServiceNow-instantie. Neem contact op met uw ServiceNow accountbeheerder.

ServiceNow admin-oplossing: Voeg de gebruiker die de fout ontvangt toe aan de gebruikerslijst van het exemplaar.