E-mail

Inleiding:

In dit artikel leggen we alles uit omtrent de e-mail actie in OBI Bots. Zo kun je hier uitleg vinden hoe je een e-mail account kunt configureren, hoe je een chatbotgebruiker kunt vragen om een e-mailadres en hoe je een e-mailadres kunt toevoegen aan jouw chatbot.

E-mail account configureren:

Met de e-mailactie kun je je chatbot op bepaalde punten in je gesprek e-mails laten versturen. Om dit te laten werken, heb je een e-mailaccount nodig en de gegevens van de SMTP-server van je mailprovider.

Je kunt elke e-mailaccount gebruiken, zolang de provider de SMTP-server voor uitgaande e-mail heeft ingeschakeld.

E-mail account configureren:

Stap 1: Ga naar Build -> Actions -> E-mail
Stap 2: Voer de SMTP-servernaam van de host in, het mailadres van waaruit de e-mails worden verzonden en het SMTP-poortnummer waarlangs de mail moet worden verzonden (standaardpoorten zijn 25, 465 of 587, controleer bij de provider voor de exacte hostnaam en het poortnummer).
Stap 3: Voer gebruikersnaam en wachtwoord in voor het mailaccount dat je hebt opgegeven in het veld Sender.
Stap 4: Selecteer welk veiligheidsprotocol OBI Bots moet gebruiken voor het verzenden van de mail (controleer bij de provider of dit TLS of SSL moet zijn).
Stap 6: Sla de e-mailconfiguratie op.

Veel gebruikte SMTP instellingen:

Veld	Gmail	Office365
Host	smtp.gmail.com	smtp.office365.com
Sender	Dit is jouw Gmail of Gsuite e-mailadres	Dit is jouw Office365 e-mailadres
Port	587	587
User	Dit is jouw Gmail f Gsuite e-mailadres	Dit is jouw Office65 e-mailadres
Password	Dit is het wachtwoord van jouw Gmail of Gsuite e-mailadres	Dit is het wachtwoord van jouw Office365 e-mailadres
UseTls	Aan	Aan
UseSsl	Uit	Uit

Let op: Google schakelt standaard het gebruik van smtp uit. Als je dat wilt gebruiken, ga dan naar deze Google-pagina en sta minder veilige apps toe: https://myaccount.google.com/lesssecureapps

Vragen om een e-mailadres:

Voordat je een e-mail kunt sturen naar een chatbotgebruiker, dien je eerst het e-mailadres vastleggen. Laten we een voorbeeld gebruiken om de chatbot naar het e-mailadres van de gebruiker te laten vragen, zodat de chatbot een mailbericht kan sturen met de bestelinformatie.

Zorg er eerst voor dat er een entity is voor e-mail, zoals system.email. Als je er nog geen hebt, maak er dan eerst een aan.

Stap 1: Maak een user intent met bijvoorbeeld de naam systeem.status zodat de chatbotgebruiker kan vragen naar de status van de order.

Stap 2: Maak een bot question waarmee de chatbot naar het e-mailadres van de chatbotgebruiker vraagt. Daarvoor hebben we een entity voor e-mail nodig, zoals systeem.email. Als je hiervoor nog geen entity hebt, kun je er een aanmaken door simpelweg de naam van de entity in te typen in het veld Entity.

Stap 3: Voeg hieraan een user turn toe zodat de chatbotgebruiker het e-mailadres kan doorgeven. Selecteer de entity voor het e-mailadres en vink de optie save user message aan.

Stap 4: Maak een bot reply om het e-mailadres van de chatbotgebruiker te bevestigen. Gebruik de variabel {{system.email}}, of de naam van je eigen entity, om het e-mailadres te laten zien in het antwoord van de chatbot.

E-mail toevoegen aan dialoog:

Wanneer je om het e-mailadres van de chatbotgebruiker hebt gevraagd, is de volgende stap om in de dialoog een e-mail actie toe te voegen.

Om dit toe te voegen ga je naar het punt in de dialoog toe waar de actie dient te komen. Voeg een action turn toe en selecteer Send email

In het veld Email Recipient heb je twee mogelijkheden:

Jouw eigen e-mailadres: wanneer je een e-mail naar jezelf wil toesturen, vul je hier jouw eigen e-mailadres in. Dit kan bijvoorbeeld gebruikt wanneer je de gehele conversatie naar jezelf wil toesturen als reminder of voor je eigen administratie.
Het e-mailadres van de chatbotgebruiker: het e-mailadres van de gebruiker heb je op een eerder punt van de conversatie verzameld. Je kunt bijvoorbeeld een e-mail toesturen met extra informatie, zoals een bevestiging. In het veld van het e-mailadres zet je dan de entity neer tussen krulhaakjes {{ }} die je hebt gebruikt voor het verzamelen van het e-mailadres, bijvoorbeeld {{system.mail}}.

Bij het instellen van de e-mail action turn vul je de volgende informatie in:

Email Recipient: het e-mailadres waar de mail naar toe gestuurd wordt.
Subject: het onderwerp van de e-mail.
Email body: de inhoud van de e-mail.

Je kunt gebruik maken van eerder opgevraagde entity values om jouw e-mail compleet te maken. Zet de entity tussen {{ }} en OBI Bots vult automatisch de opgeslagen waardes in. Mocht OBI Bots niets hebben gevonden, dan ziet de chatbotgebruiker de entity met {{ }} in de e-mail.

Voorbeeld: Google

Google schakelt standaard het gebruik van smtp uit. Als u dat wilt gebruiken, ga dan naar deze Google-pagina en sta minder veilige apps toe: https://myaccount.google.com/lesssecureapps