Een chatbot bouwen voor Google Chat

Waarom een chatbot voor Google Chat?

Een chatbot in Google Chat kan repetitieve taken automatiseren, informatie ophalen uit andere systemen en acties uitvoeren zonder dat gebruikers een aparte applicatie hoeven te openen. Denk aan een bot die verlofaanvragen verwerkt, de status van een supportticket ophaalt, of dagelijkse standups coordineert.

Google Chat biedt twee manieren om bots te bouwen:

1. Google Apps Script: laagdrempelig, geen externe hosting nodig en directe integratie met Google Workspace.
2. Externe HTTP-webhook of Cloud Function: volledige controle, geschikt voor complexe logica en integraties met externe API's.

Voorbereiding: Google Cloud-project opzetten

Methode 1: Bot bouwen met Apps Script

Apps Script-project aanmaken

function onMessage(event) {
  var userMessage = event.message.text || '';
  var userName = event.user.displayName;

  if (userMessage.toLowerCase().indexOf('help') !== -1) {
    var hulp = 'Hallo ' + userName + '! Ik kan je helpen met:
'
      + '- /status: projectstatus ophalen
'
      + '- /verlof: verlofaanvraag indienen';
    return { text: hulp };
  }

  return {
    text: 'Ik heb je bericht ontvangen. Typ "help" voor de beschikbare commandos.'
  };
}

function onAddToSpace(event) {
  return {
    text: 'Hallo! Ik ben je nieuwe assistent-bot. Typ "help" voor meer informatie.'
  };
}

function onRemoveFromSpace(event) {
  console.log('Bot verwijderd uit Space: ' + event.space.name);
}

De callbacknamen onMessage, onAddToSpace en onRemoveFromSpace zijn de namen die Apps Script verwacht. Je koppelt ze straks in de Chat API-configuratie.

Apps Script publiceren als Chat-app

Methode 2: Bot bouwen met een externe webhook

Voor complexere bots gebruik je een externe server, bijvoorbeeld Cloud Run, Cloud Functions of een eigen server. Bij Verbindingsinstellingen kies je dan niet voor Apps Script, maar voor een HTTP-endpoint-URL.

Cloud Function aanmaken

const functions = require('@google-cloud/functions-framework');

functions.http('chatbot', (req, res) => {
  const event = req.body;

  if (event.type === 'MESSAGE') {
    const userMessage = event.message.text;
    const userName = event.user.displayName;

    res.json({
      text: 'Hallo ' + userName + ', ik heb je bericht ontvangen: ' + userMessage
    });
  } else if (event.type === 'ADDED_TO_SPACE') {
    res.json({ text: 'Bedankt voor de uitnodiging! Ik sta klaar om te helpen.' });
  } else {
    res.json({});
  }
});

Kaarten (cardsV2) gebruiken voor rijkere reacties

Google Chat-bots kunnen rijke kaarten teruggeven in plaats van platte tekst. Een kaart kan knoppen, afbeeldingen en gestructureerde informatie bevatten:

function createCard(titel, beschrijving, knopTekst, knopUrl) {
  return {
    cardsV2: [{
      cardId: 'info-card',
      card: {
        header: {
          title: titel,
          subtitle: beschrijving
        },
        sections: [{
          widgets: [{
            buttonList: {
              buttons: [{
                text: knopTekst,
                onClick: {
                  openLink: { url: knopUrl }
                }
              }]
            }
          }]
        }]
      }
    }]
  };
}

Slash-commando's registreren

Slash-commando's geven gebruikers een intuitieve manier om de bot aan te sturen. Je registreert ze in de Chat API-configuratie:

1. Ga naar de Google Chat API-configuratie in je Cloud-project.
2. Scroll naar Slash-commando's.
3. Voeg commando's toe, bijvoorbeeld /status, /verlof en /help.
4. Elk commando krijgt een ID (een getal) waarmee je het in code herkent.

In de botcode herken je een slash-commando via het veld event.message.slashCommand:

if (event.message.slashCommand) {
  const commandId = event.message.slashCommand.commandId;
  if (commandId === 1) { // /status
    return getProjectStatus();
  }
}

De bot toevoegen aan een Space

Testen en debuggen

Test je bot systematisch:

• Stuur directe berichten naar de bot via een DM.
• Test alle geregistreerde slash-commando's.
• Test edge-cases: lege berichten, speciale tekens en lange teksten.
• Controleer de logboeken via Apps Script (Uitvoeren > Logboeken) of via Cloud Logging bij een externe webhook.