200 lines
8.6 KiB
Markdown
200 lines
8.6 KiB
Markdown
---
|
||
substitutions:
|
||
IAP: '{abbr}`IAP (In-app purchases)`'
|
||
---
|
||
|
||
# In-app purchases (IAP)
|
||
|
||
In-app purchases (IAP) are optional services that enhance Odoo databases. Each service provides its
|
||
own specific features and functionality. A full list of services is available on the [Odoo IAP
|
||
Catalog](https://iap.odoo.com/iap/all-in-app-services).
|
||
|
||
```{image} in_app_purchase/iap.png
|
||
:align: center
|
||
:alt: The IAP catalog with various services available on IAP.Odoo.com.
|
||
```
|
||
|
||
```{eval-rst}
|
||
.. example::
|
||
The :guilabel:`SMS` service sends text messages to contacts directly from the database, and the
|
||
:guilabel:`Documents Digitization` service digitizes scanned or PDF vendor bills, expenses, and
|
||
resumes with optical character recognition (OCR) and artificial intelligence (AI).
|
||
```
|
||
|
||
{{ IAP }} services do **not** need to be configured or set up before use. Odoo users can simply click on
|
||
the service in the app to activate it. However, each service requires its own prepaid credits, and
|
||
when they run out, users **must** {ref}`buy more <iap-buying-credits>` in order to keep using it.
|
||
|
||
:::{note}
|
||
Enterprise Odoo users with a valid subscription get free credits to test IAP features before
|
||
deciding to purchase more credits for the database. This includes demo/training databases,
|
||
educational databases, and one-app-free databases.
|
||
:::
|
||
|
||
(in-app-purchase-portal)=
|
||
|
||
## IAP services
|
||
|
||
{{ IAP }} services are provided by Odoo, as well as third-parties, and have a wide range of uses.
|
||
|
||
The following {{ IAP }} services are offered by Odoo:
|
||
|
||
- {guilabel}`Documents Digitization`: digitizes scanned or PDF vendor bills, expenses, and resumes
|
||
with OCR and AI.
|
||
- {guilabel}`Partner Autocomplete`: automatically populates contact records with corporate data.
|
||
- {guilabel}`SMS`: sends SMS text messages to contacts directly from the database.
|
||
- {guilabel}`Lead Generation`: generates leads based on a set of criteria, and converts web visitors
|
||
into quality leads and opportunities.
|
||
- {guilabel}`Snailmail`: sends customer invoices and follow-up reports by post, worldwide.
|
||
- {guilabel}`Signer identification with itsme®️`: ask document signatories in Odoo *Sign* to provide
|
||
their identity using the *itsme®* identity platform, which is available in Belgium and the
|
||
Netherlands.
|
||
|
||
For more information on every service currently available (offered from developers other than Odoo),
|
||
visit the [Odoo IAP Catalog](https://iap.odoo.com/iap/all-in-app-services).
|
||
|
||
### Use IAP services
|
||
|
||
{{ IAP }} services are automatically integrated with Odoo, and do **not** require users to configure any
|
||
settings. To use a service, simply interact with it wherever it appears in the database.
|
||
|
||
```{eval-rst}
|
||
.. example::
|
||
The following flow focuses on the *SMS* |IAP| service being used from a contact's record.
|
||
|
||
This can be done by clicking the :guilabel:`📱 SMS` icon within the database.
|
||
|
||
.. image:: in_app_purchase/sms-icon.png
|
||
:align: center
|
||
:alt: The SMS icon on a typical contact information form located within an Odoo database.
|
||
|
||
One way to utilize the *SMS* |IAP| service with Odoo is showcased in the following steps:
|
||
|
||
First, navigate to the :menuselection:`Contacts application`, and click on a contact with a
|
||
mobile phone number entered in either the :guilabel:`Phone` or :guilabel:`Mobile` field of the
|
||
contact form.
|
||
|
||
Next, find the :guilabel:`📱 SMS` icon that appears to the right of the :guilabel:`Phone` or
|
||
:guilabel:`Mobile` fields. Click the :guilabel:`📱 SMS` icon, and a :guilabel:`Send SMS Text
|
||
Message` pop-up window appears.
|
||
|
||
Type a message in the :guilabel:`Message` field of the pop-up window. Then, click the
|
||
:guilabel:`Send SMS` button. Odoo then sends the message, via SMS, to the contact, and logs what
|
||
was sent in the *chatter* of the contact's form.
|
||
|
||
Upon sending the SMS message, the prepaid credits for the *SMS* |IAP| service are automatically
|
||
deducted from the existing credits. If there are not enough credits to send the message, Odoo
|
||
prompts the user to purchase more.
|
||
```
|
||
|
||
:::{seealso}
|
||
For more information on how to use various {{ IAP }} services, and for more in-depth instructions
|
||
related to SMS functionality in Odoo, review the documentation below:
|
||
|
||
- {doc}`Lead mining <../sales/crm/acquire_leads/lead_mining>`
|
||
- {doc}`Enrich your contacts base with Partner Autocomplete
|
||
<../sales/crm/optimize/partner_autocomplete>`
|
||
- {doc}`SMS Marketing <../marketing/sms_marketing>`
|
||
:::
|
||
|
||
(in-app-purchase-credits)=
|
||
|
||
## IAP credits
|
||
|
||
Every time an {{ IAP }} service is used, the prepaid credits for that service are spent. Odoo prompts
|
||
the purchase of more credits when there are not enough credits left to continue using a service.
|
||
Email alerts can also be set up for when {ref}`credits are low <in-app-purchase-low-credits>`.
|
||
|
||
Credits are purchased in *Packs* from the [Odoo IAP Catalog](https://iap.odoo.com/iap/all-in-app-services), and pricing is specific to each service.
|
||
|
||
```{eval-rst}
|
||
.. example::
|
||
The `SMS service <https://iap.odoo.com/iap/in-app-services/1>`_ has four packs available, in
|
||
denominations of:
|
||
|
||
- :guilabel:`Starter Pack`: 10 credits
|
||
- :guilabel:`Standard Pack`: 100 credits
|
||
- :guilabel:`Advanced Pack`: 500 credits
|
||
- :guilabel:`Expert Pack`: 1,000 credits
|
||
|
||
.. image:: in_app_purchase/packs.png
|
||
:align: center
|
||
:alt: Four different packs of credits for the SMS IAP service.
|
||
|
||
The number of credits consumed depends on the length of the SMS and the country of destination.
|
||
|
||
For more information, refer to the :doc:`SMS Pricing and FAQ
|
||
<../marketing/sms_marketing/pricing_and_faq>` documentation.
|
||
```
|
||
|
||
(iap-buying-credits)=
|
||
|
||
### Buy credits
|
||
|
||
If there are not enough credits to perform a task, the database automatically prompts the purchase
|
||
of more credits.
|
||
|
||
Users can check the current balance of credits for each service, and manually purchase more credits,
|
||
by navigating to the {menuselection}`Settings app --> Contacts section`, and beneath the
|
||
{guilabel}`Odoo IAP` setting, click {guilabel}`View My Services`.
|
||
|
||
Doing so reveals an {guilabel}`IAP Service` page, listing the various {{ IAP }} services in the
|
||
database. From here, click an {{ IAP }} service to open its {guilabel}`Account Information` page, where
|
||
additional credits can be purchased.
|
||
|
||
#### Manually buy credits
|
||
|
||
To manually buy credits in Odoo, follow these steps:
|
||
|
||
First, go to the {menuselection}`Settings application` and type `IAP` in the {guilabel}`Search...`
|
||
bar. Alternatively users can scroll down to the {guilabel}`Contacts` section. Under the
|
||
{guilabel}`Contacts` section, where it says {guilabel}`Odoo IAP`, click {guilabel}`View My
|
||
Services`.
|
||
|
||
```{image} in_app_purchase/view-services.png
|
||
:align: center
|
||
:alt: The Settings app showing the Odoo IAP heading and View My Services button.
|
||
```
|
||
|
||
Doing so reveals an {guilabel}`IAP Account` page, listing the various {{ IAP }} services in the
|
||
database. From here, click an {{ IAP }} service to open its {guilabel}`Account Information` page, where
|
||
additional credits can be purchased.
|
||
|
||
On the {guilabel}`Account Information` page, click the {guilabel}`Buy Credit` button. Doing so loads
|
||
a {guilabel}`Buy Credits for (IAP Account)` page in a new tab. From here, click {guilabel}`Buy` on
|
||
the desired pack of credits. Then, follow the prompts to enter payment details, and confirm the
|
||
order.
|
||
|
||
```{image} in_app_purchase/buy-pack.png
|
||
:align: center
|
||
:alt: The SMS service page on IAP.Odoo.com with four packs of credits available for
|
||
: purchase.
|
||
```
|
||
|
||
Once the transaction is complete, the credits are available for use in the database.
|
||
|
||
(in-app-purchase-low-credits)=
|
||
|
||
#### Low-credit notification
|
||
|
||
It is possible to be notified when credits are low, in order to avoid running out of credits, while
|
||
using an {{ IAP }} service. To do that, follow this process:
|
||
|
||
Go to the {menuselection}`Settings application`, and type `IAP` in the {guilabel}`Search...` bar.
|
||
Under the {guilabel}`Contacts` section, where it says {guilabel}`Odoo IAP`, click {guilabel}`View My
|
||
Services`.
|
||
|
||
The available {{ IAP }} accounts appear in a list view on the {guilabel}`IAP Account` page. From here,
|
||
click on the desired {{ IAP }} account to view that service's {guilabel}`Account Information` page.
|
||
|
||
On the {guilabel}`Account Information` page, tick the {guilabel}`Warn Me` checkbox. Doing so reveals
|
||
two fields on the form: {guilabel}`Threshold` and {guilabel}`Warning Email`.
|
||
|
||
In the {guilabel}`Threshold` field, enter an amount of credits Odoo should use as the
|
||
minimum threshold for this service. In the {guilabel}`Warning Email` field, enter the email address
|
||
that receives the notification.
|
||
|
||
Odoo sends a low-credit alert to the {guilabel}`Warning Email` when the balance of credits falls
|
||
below the amount listed as the {guilabel}`Threshold`.
|
||
|