eva-library / channel-infobip

Infobip connector integrated with eva.

Infobip eva

This connector has been created using infobip, it shows how to incorporate eva conversational flow.

This application is a Spring Boot app and uses the Azure Kubernetes Service (AKS) to deploy to Azure.

1. Deployment

• Documentation

2. Prerequisites

• Java 1.8+
• Install Maven
• eva's preinstallation
• An account on Azure if you want to deploy to Azure.
• Infobip account and get a phone number
• kubectl
• docker

3. To try this sample locally

• From the root of this project folder:

  • Build the sample using mvn package
  • Run it by using java -DEVADB_DS_URL="put eva db url here" -DEVADB_DS_USER="put eva db user here" -DEVADB_DS_PWD="put eva db pass here" -jar .\target\gidp-eva-infobip-3.2.2.0.jar

• Test full connectivity using infobip phone number

  • All eva's components must be up locally
  • Add the infobip URL (http://localhost:8050/conversations) as a Any Other Keyword
  • Add the phone number in your phone contacts and open a chat in WhatsApp
  • Send a message

4. Infobip channel

4.1 Adding Keywords

Open infobip portal > Apps > Numbers

Click on you phone number previously created, add the keyword and set the microservice infobip endpoint deployed on your cloud

Keywords:

• IMAGE(keyword bot eva)
• DOCUMENT(document name)
• VOICE
• Keyword to reference eva bot

Use ANY OTHER KEYWORD to redirect all incoming messages to one specific endpoint

4.2 Add Keyword to eva's configuration

Open cockpit home, click on settings.

In parameters add information provided from infobip and eva configuration:

- whatsapp.infobip.info -> {"omniUrl":"<>","user":"<>","password":"<>","whatsappNumber":"<>","channel":"WHATSAPP","keyword":"<keyword to reference eva bot>"}
- whatsapp.broker.info -> {"baseUrl":"http://eva-broker:8080","apiKey":"eva API KEY","project":"eva project name","channel":"WhatsApp","os":"Infobip connector","locale":"project language"}

*Example:

- whatsapp.infobip.info -> {"omniUrl":"https://api.infobip.com/omni/1/","user":"[e-mail]","password":"123456789","whatsappNumber":"34638202449","channel":"WHATSAPP","keyword":"GIDP"}
- whatsapp.broker.info -> {"baseUrl":"http://eva-broker:8080","apiKey":"12345678","project":"GIDP WA","channel":"WhatsApp","os":"Infobip connector","locale":"es-ES"}

Further reading

• Maven Plugin for Azure App Service
• Spring Boot
• Azure for Java cloud developers
• Activity processing
• Azure Bot Service Introduction
• Azure Bot Service Documentation
• Infobip Documentation

*Components are not supported