# Infobip Exchange

[Infobip](https://www.infobip.com/signup?signup_source=OrangePill) is a leading global onmichannel communication platform. Using Infobip you can build conversational interface for WhatsApp, Telegram, Viber and many other channels.

Use [Orangepill](https://orangepill.cloud) integration with [Infobip Answers](https://www.infobip.com/answers) to build Conversational Wallet products.

Use pre-built Orangepill functions to access account details, transaction history, create transactions, deposit, execute withdrawals and apply fees in easy to use drag-and-drop enabled environmnet. Access all features of Orangepill platform from chatbots. Extend conversational experiance for your customers using all features of Infobip platform.

## Conversational Wallet

A Conversational Wallet is an interface or platform that leverages the capabilities of Infobip and Orangepill. It is a financial technology solution, to provide a conversational and interactive channel for various financial services. It enables users to interact with their financial accounts, perform transactions and obtain information through conversations with a virtual assistant or chatbot.

The benefits of using a conversational channel for financial solutions are numerous:

1. Seamless User Experience: Conversational interfaces mimic human-like interactions, making it more intuitive and user-friendly compared to traditional graphical user interfaces. Users can interact with the Conversational Wallet through voice or text, allowing for a more natural and personalized experience.
2. Accessibility and Convenience: Conversational Wallets provide easy access to financial services anytime, anywhere. Users can engage with the platform using their preferred devices such as smartphones, smart speakers, or messaging apps, eliminating the need for physical visits to banks or websites.
3. Personalized Financial Guidance: By leveraging AI algorithms and user data, Conversational Wallets can offer tailored financial advice and recommendations based on an individual's financial goals, spending patterns, and preferences. Users can receive personalized insights, budgeting tips, investment suggestions, and reminders for bill payments, helping them make informed financial decisions.
4. Transactional Capabilities: Conversational Wallets enable users to perform various financial transactions directly through the interface. Users can transfer funds, pay bills, manage subscriptions, check account balances, and initiate investment transactions using simple text commands. This streamlines the financial management process and eliminates the need for multiple apps or interfaces.
5. Enhanced Security: Conversational Wallets can incorporate advanced security measures, such as multi-factor authentication and encryption, to ensure the privacy and safety of financial data. User interactions are securely encrypted, minimizing the risk of fraud or unauthorized access to sensitive information.
6. Improved Financial Literacy: Conversational Wallets can act as personalized financial assistants, providing educational content and explanations and money management techniques. Users can ask questions, seek clarifications, and receive educational materials, fostering financial literacy and empowering individuals to make better financial decisions.
7. Integration with Third-Party Services: Conversational Wallets can integrate with various third-party services, such as utility providers, e-commerce platforms, and financial institutions, enabling seamless transactions and data sharing. This integration expands the scope of financial services accessible through the Conversational Wallet and enhances its overall functionality.

Conversational Wallets powered by [Infobip Answers](https://www.infobip.com/answers) and Orangepill provide an innovative and efficient way to engage with financial services. They offer a personalized, convenient, and secure channel for managing finances, accessing information, and receiving tailored financial guidance, revolutionizing the way individuals interact with their money.

## Signup

To start building Conversational Wallets you must first signup to Infobip and Orangepill.

### Infobip signup

Go to [https://www.infobip.com/signup](https://www.infobip.com/signup?signup_source=OrangePill) and create your Infobip account.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FiTlZPqtdru9uG4aqYtmg%2Finfobip_signup.png?alt=media&#x26;token=a79b062d-d71a-4dda-9a23-50929eeeaa53" alt=""><figcaption></figcaption></figure>

Once your signup process is complete you will have access to Infobip portal.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FW4uWMx9I0hbtQU75TIkk%2Finfobip_portal_home.png?alt=media&#x26;token=689e6ed6-3179-4997-9549-ab9fdafad76d" alt=""><figcaption></figcaption></figure>

### Orangepill signup

Go to <https://orangepill.cloud/user/register> and create your Orangepill account.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FryiVgCEHK0RIDmLeKM0n%2FOrangepill_signup.png?alt=media&#x26;token=6ba2cb80-28ca-4517-bb84-d1f40fd21994" alt=""><figcaption></figcaption></figure>

Once your signup process is complete you will have access to Orangepill console.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FQjvSlCMsUm1EZyqobJjU%2FOrangepill_console_home.png?alt=media&#x26;token=896148eb-f463-48d4-ada8-685febb05fc5" alt=""><figcaption></figcaption></figure>

To start building conversational wallet solution you must first create a new realm. Realm is a domain of data related to one project. Realm data will be related to Infobip Answers integration. To create a new realm select your country and base accounting currency.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FuqQIZlfZFK44z2oEkovi%2FOrangepill_create_realm.png?alt=media&#x26;token=1b86a6d4-1f4d-450a-8d26-f3cfa38ac0b0" alt=""><figcaption></figcaption></figure>

To connect Orangepill realm with Infobip Answers you will need realm key data and a username and password of your Orangepill account.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2Fqkn7XQJBqGWD0rlHiquu%2FOrangepill_realm_details.png?alt=media&#x26;token=b82165c9-56dd-4c75-892d-f6c8737816ac" alt=""><figcaption></figcaption></figure>

### Enable Orangepill integration

Find Orangepill app in Infobip Exchange marketplace.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2Fpzps3o3EsBaXAkzoT8Yi%2FInfobip_exchange.png?alt=media&#x26;token=7d63b0f2-09c3-424a-9fe2-0a0f3805ec0d" alt=""><figcaption></figcaption></figure>

Open Orangepill app and add it to your account.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FcjH7MknH1sksPXa5X4zu%2FInfobip_exchange_orangepill.png?alt=media&#x26;token=25160628-c470-472a-a3de-b469c764bc04" alt=""><figcaption></figcaption></figure>

Go to publish section and choose option to configure Orangepill integration.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FYpjZoZY44THe7HLvPm1a%2FInfobip_exchange_configure_orangepill.png?alt=media&#x26;token=beb5fac6-31b3-4ad9-8840-72dceaf3883f" alt=""><figcaption></figcaption></figure>

To connect Orangepill realm with your Infobip account enter realm key, Orangepill user credentials (you should be gotten them on your email) and a name (Informative name to know the purpose of your integration).

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2Fh88dvEC0yGRIczMpxqG4%2Fimage.png?alt=media&#x26;token=991b7e96-55a5-4f74-b33f-45e8eb17adab" alt=""><figcaption></figcaption></figure>

You are all set to start building conversational wallet.

### Register multiples realms on the same Infobip account (Optional)

Some customer could have more than on product, such as a Wallet, Digital Bank and so on, and they want to have a realm per product, for those uses cases they can leverage the same Infobip Account to have multiple chat bot (one per product), and here you have the step by step guide to get this done.

#### Register a second realm

First you have to go the exchanges section there you have to press my apps option.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FlRMdXAKmlRwzTvP2VyBa%2Fimage.png?alt=media&#x26;token=e49ec0d0-5762-4841-be78-1ac3cf592efa" alt=""><figcaption></figcaption></figure>

Then you have to press over the Answer for Orangepill app, and you will be redirected to the next view.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FnBFhKCvi9lcvNwvmnkXW%2Fimage.png?alt=media&#x26;token=38d0b091-314c-4ab6-a5dc-daef3d1d5c0e" alt=""><figcaption></figcaption></figure>

Here you have to press the OPEN button and then you will see the form to register the new realm

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FeEUWtyWr6t3ZpQoDJgLG%2Fimage.png?alt=media&#x26;token=49b22ee6-d162-4dbf-a2f6-73441db69dee" alt=""><figcaption></figcaption></figure>

Finally you have to send the realm key on all requests you made from the bot.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FGh7a6mXndnX39gvlloAN%2Fimage.png?alt=media&#x26;token=c2b31ddb-dbbb-45fb-9245-57fd3fcd7a06" alt=""><figcaption></figcaption></figure>

If you don’t send it, the API will take the oldest realm key registered under your Infobip account.

## Build

### Chatbot

Use Answers->Chatbots to add new chatbot.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2F4kcc7ncXeLJioj24P7KR%2FInfobip_exchange_answers_chatbots.png?alt=media&#x26;token=90dac63d-cc77-42c6-9074-57f9097bf208" alt=""><figcaption></figcaption></figure>

Choose to build it from the scratch.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FVOgRgm9KHyUWBBlBNlOW%2FInfobip_exchange_chatbot_from_scratch.png?alt=media&#x26;token=092fc039-76d6-4974-a92e-5a094f67691f" alt=""><figcaption></figcaption></figure>

Configure chatbot name, channel and language.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2F1ZXyXBlaJU4cZqWSemwx%2FInfobip_exchange_configure_chatbot.png?alt=media&#x26;token=e354ea39-a6bc-4382-a171-1f90f4a02c2a" alt=""><figcaption></figcaption></figure>

Use Infobip chatbot builder to develop conversational wallet for your use case.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FStSijlBlgu7dX79SMOXb%2FInfobip_exchange_chatbot_builder.png?alt=media&#x26;token=1e2ebde9-cc21-4a7d-8098-7b75638ac3b8" alt=""><figcaption></figcaption></figure>

For detaild documentation on Infobip conversational experiences consult <https://www.infobip.com/docs>.

### Impersonate Users

To relate chatbot user with Orangepill identity you must assign Orangepill alias value to match unique channel identifier. For WhatsApp, Viber, Line unique identifier is a phone number. For Telegram you must set user nickname or phone number.

{% hint style="info" %}
To impersonate user for Infobip chatbot simulator, assign alias WEB\_SIMULATION.
{% endhint %}

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FHcT4LEQipSzBZJaWR3ng%2FOrangepill_create_alias.png?alt=media&#x26;token=b2846014-6fcb-4cd3-aa23-7ecd0f40275d" alt=""><figcaption></figcaption></figure>

### Orangepill Actions for Answers

Choose Orangepill Action for Answers and add it to your chatbot flow.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2Fovsqf0bPirRKihZQUiWY%2FOrangepill_infobip_actions_list.png?alt=media&#x26;token=786562e3-3822-4b3f-9095-80ff1dffcb2a" alt="" width="375"><figcaption></figcaption></figure>

To engage Orangepill Action you must collect input values using Infobip global or local attributes.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2Fsf4gHuk7cYgfXSQmYY5v%2FOrangepill_infobip_actions_settings.png?alt=media&#x26;token=d553de19-e4ba-4cdf-8755-9427711599bd" alt="" width="375"><figcaption></figcaption></figure>

#### Get all accounts

List all accounts and balances of current aliased user.

#### Get virtual accounts

List all virtual accounts and balances of current aliased user.

To learn more about Orangepill virtual accounts check this [documentation page.](https://docs.orangepill.cloud/orangepill-api/virtual-accounts)

#### Get ramp accounts

List all ramp accounts and balances of current aliased user.

{% hint style="info" %}
Use blockchain address displayed with ramp account to make deposit from external wallet.
{% endhint %}

To learn more about Orangepill ramp accounts check this [documentation page.](https://docs.orangepill.cloud/orangepill-api/ramp-accounts)

#### Make transaction

Make transaction between two accounts. Provide source account of current aliased user and type alias of target account. You can use alias of target user instead of account. This will resolve default account for specific asset for target aliased user.

To learn more about Orangepill transactions check this [documentation page.](https://docs.orangepill.cloud/orangepill-api/transactions)

#### Get incoming transactions

List incoming transfers to selected account.

#### Get outgoing transactions

List outgoing transfers from selected account.

#### Make withdrawal

Initiate withdrawal of assets to blockchain address.

To learn more about Orangepill withdrawals check this [documentation page.](https://docs.orangepill.cloud/orangepill-api/withdrawal)

#### Get withdrawals

List withdrawals history.

### Deploy

To deploy chatbot use Activate button on Infobip portal.

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FVXgA6Iipiif0x1zmSMfK%2FInfobip_exchange_chatbot_activate.png?alt=media&#x26;token=2e9a9e67-8ab5-47b6-b806-26b4bca07f55" alt=""><figcaption></figcaption></figure>

#### Simulator

While developing you can use chatbot simulator to test and debug. Remember to assign alias WEB\_SIMULATION to Identity you want to impersonate in simulator.&#x20;

<figure><img src="https://3218614644-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoAQr9l0l72LlC4cHtGP0%2Fuploads%2FP529AnGEzzm1chJq2EDU%2FInfobip_exchange_simulator.png?alt=media&#x26;token=d0520535-fd90-4f26-9af3-6ce1c8e9813c" alt=""><figcaption></figcaption></figure>

## Use cases

### Digital bank

Use Orangepill virtual currencies to implement support for FIAT. Operations of issue and destroy of virtual currency should map to operations of debit and credit.

You can extend conversational experiance with other Infobip building blocks like Moments and Conversations to provide complete experience, including interaction with live agents.

### Wallet for crypto assets

Use any of [45+ supported crypto assets](https://docs.orangepill.cloud/orangepill-api/digital-assets) to create accounts, deposits and withdrawals for end user. Use virtual accounts to enable off-chain transactions for your users and optimize costs of blockchain processing.

More information about building crypto wallet you can find [here](https://docs.orangepill.cloud/tutorials/simple-eth-wallet).

More information about building complete crypto exchange solution you can find [here](https://docs.orangepill.cloud/tutorials/cryptocurrency-exchange).

More information about building crypto payment acceptence you can find [here](https://docs.orangepill.cloud/integrations/broken-reference).

### Loyalty points and Cashback solutions

You can create virtual currencies to represent loyalty points or cashback values. Apply automatic fees and comissions in fixed or percantage amount to enable your use case.

Find more information about automatic forwarding of transaction amounts [here](https://docs.orangepill.cloud/smartapps/forwarding-transactions).
