Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
InfoIn this guide, you will discover the essential steps for setting up
Info

In this guide, you will discover the essential steps for setting up and customising your CRM.COM Apps specifically for your business needs. We'll also cover mandatory and optional features of CRM.COM that you can utilise to amplify the functionality of the apps further.

The same procedure, can be followed for the CRM.COM release web portal too.


Step 1 - Create the App

First of all, you must create the app. Sign in to CRM.COM using your user credentials and navigate to Settings > Platform > Contact-Facing Essentials > Apps. Select Create Application.

  • Name - Provide the app name, which will appear on the welcome screen (a.k.a Landing Page).

  • Application Type - Select one of the two application types below:

    • Contact App - A consumer-facing app that allows a business's contacts to register and have self-service access to the entire set of CRM.COM features such as access to personal and financial information, manage their CRM.COM Wallet, view your product catalogue, offers and promotions, place their orders and much more!

    • Contact Portal - A web-based portal offering the same features and user experience as the Contact App.

    • Merchant App - A mobile app that allows business and merchant users to identify contacts at the point-of-sale and submit their purchases with optional spend.

  • Click Save.

Refer to the Apps manual for further information.

Now that the app has been created, you’ll need to configure the app’s settings in the next step.

Info

The Merchant App can be created and published by either a Service Owner or a specific Business. If it's set up at the Service Owner level, all Business users affiliated with that Service Owner can access and use the app, eliminating the need to create and publish their own version. On the other hand, if a Business configures and publishes its own Merchant App, then only users from that particular Business will be able to sign in and use it.

Now that the app has been created, you’ll need to configure the app’s settings in the next step.

Step 2 - Setup the App

Setting up your app involves:

  • Branding your business app by specifying colours, uploading images and setting its look and feel.

  • Enabling the CRM.COM features that you'll allow your contacts to use for self-service purposes.

To set up the app navigate to Settings > Platform > Contact-Facing Essentials > Apps > View the app in question > select the respective tab.

Note

The user interface has detailed instructions and tips for setting up the app's settings.

Appearance

When an app is created, default colour settings are applied, but you can customise them with your own business branding colours and images.

Info

Refer to the Appendix at the end of this guide for a comprehensive list of image specifications. It is also important to note that you can view each image's specifications within the user interface when uploading. Make sure your images meet these specifications for the best possible result!

Colours

  • Background Colour / Background Image - This is used on the app’s landing page once a contact launches the app. You can set either a colour or an image. If both are provided, the background image will be used.

  • Colour Scheme - These are your app’s branding colours, and are used throughout the app.

    • Primary Colour - This colour is used to highlight selectable icons or text buttons and for the selected option and action buttons.

    • Secondary Colours - This colour is used for available options but not the selected option.

Creatives

  • Appliation App logo - Upload your business logo. It will be used in the following ways:

    • Displayed on the Home screen to represent your business.

    • Shown on the CRM.COM Wallet screen to indicate business-related balances (Business Pocket and Commerce Pocket).

    • Used in place of a product image , reward offer, donations and promotions images (if the product corresponding entity doesn’t have one).

  • Carousel - This is particularly beneficial for highlighting your business in a visually appealing manner on the app's Home screen. You can optionally upload one or more images.

Features

About

This section contains the legal details related to the app, where businesses can define their Terms and & Conditions and Privacy Policy. If provided, users must accept both when registering via the app or portal.

Completing this section is optional but recommended, we offer a free template in case your business doesn't already have its own policies. Should you use the template, be sure to review all content thoroughly and replace the placeholder with your business name where indicated.

Modules

Take some time to review and enable the options and features that you will provide to your contacts through your app. Keep in mind that some options can't be disabled and will, therefore, appear in the app.

Note that in order to set up your app's features properly, you need to configure certain settings within CRM.COM. Here's a list of the required setup tasks that must be completed before enabling features in your app.

  • Payment Gateways - If you will be accepting payments or allowing your contacts to Top-up their CRM.COM Wallet through the app, then enable a Payment Gateway in Platform > Integrations > Payment Gateways. You can enable the CRM.COM Wallet Gateway or any other local or global Payment Gateway service there. Find out more about payment gateways here.

  • Order Queues - This is for businesses that want to enable e-Ordering flows from the app. A default Order Queue is pre-configured for your business, but you can configure additional queues to handle the different supply methods by navigating to Settings > Commerce > Orders > Queues. Find out more about order queues here.

Step 3 - CRM.COM Set Up

Info

To ensure the app functions correctly, you must configure your business rules and processes in the back-end system in addition to setting up the app's settings. We recommend reviewing the following options, some of which are mandatory while others are optional, and determining which ones to configure based on your specific business requirements.

Contact Authentication

Status
colourGreen
titlemandatory

Navigate to Settings > Contacts & CRM > Contacts > Contact Authentication & Identities and choose how your contacts will register and sign in to the app (i.e. how they will identify themselves). You can set up the same authentication method for multiple apps, for example select email/OTP for both your mobile app and web portal.

Optionally, you can set the accepted country calling codes, which are necessary if you choose the Phone/OTP authentication method and when contacts want to link their CRM.COM Wallet with their phone number.

Find out more about contact authentication here.

Community Relations

Product Catalogue

Status
colourBlue
titleoptional

If you plan to showcase your product offerings using the app, make sure that you complete the product set-up in the back end.

Within the app, products are displayed:

  • To promote your offerings and promotions, such as a SKU-based reward offers.

  • During the ordering flow (if enabled in the app’s settings). In this case, products are displayed hierarchically to facilitate contacts in their ordering process. If you wish to support such a flow, then you have two options:

    • Set up Product Categories in the back-end and assign to products OR

    • Set up an Order Catalogue and categorise your product offerings in this catalogue.

Note that if an Order Catalogue is configured, then it has priority over the categorisation based on Product Categories.

To set up your products navigate to Commerce > Products > Product Catalogue. Refer to the Product Catalaogue manual for assistance on setting up your products.

Set Up Products

Improve your productIn the next step of this guide, we will walk you through each features required configuration.

Step 3 - CRM.COM Set Up

Info

To ensure the app functions correctly, you should configure your business rules and processes in the back-end system in addition to setting up the app's settings. We recommend reviewing the following options, some of which are mandatory while others are optional, and determining which ones to configure based on your specific business requirements. Also note that you can enable/disable the app’s features at any time, even after being published.

Contact Authentication

Status
colourGreen
titlemandatory

Navigate to Settings > Contacts & CRM > Contacts > Contact Authentication & Identities and choose how your contacts will register and sign in to the app (i.e. how they will identify themselves). You can set up the same authentication method for multiple apps, for example select email/OTP for both your mobile app and web portal.

Optionally, you can set the accepted country calling codes, which are necessary if you choose the Phone/OTP authentication method and when contacts want to link their CRM.COM Wallet with their phone number.

Find out more about Contact Authentication here.

Community Relations

Status
colourBlue
titleoptional

If you allow your contacts to create and manage their own Communities, then make sure that you also set up Community Relations in Settings > Contacts & CRM > Contacts > Community Relations. Note that in the front-end, contacts can invite others to join their community only if they specify their relation to them.

Product Catalogue

Status
colourBlue
titleoptional

If you plan to showcase your product offerings through the app, make sure that you complete the product set-up in the back end.

Within the app, products are displayed:

  • To promote your offerings and promotions, such as a SKU-based reward offers.

  • During the ordering flow (if enabled in the app’s settings). In this case, products are displayed hierarchically to facilitate contacts in their ordering process. If you wish to support such a flow, then you have two options:

    • Set up Product Categories in the back-end and assign to products OR

    • Set up an Order Catalogue and categorise your product offerings in this catalogue.

Note that if an Order Catalogue is configured, then it has priority over the categorisation based on Product Categories.

To set up your products navigate to Commerce > Products > Product Catalogue. Refer to the Product Catalaogue manual for assistance on setting up your products.

Set Up Products

Improve your product's traceability and the contacts app experience by utilising the following important information:

  • Meaningful names and descriptions.description

  • Pricing information (if applicable).

  • Categories.

  • Images.

Note

Optimise your marketing strategy with CRM.COM’s AI Tool which categorises your products and generates impactful descriptions. You can find it in Settings > Commerce > Products.

Product Images

For each product you can upload:

  • An individual image, used as the product’s primary image in the app.

  • A collection of images suitable for showcasing detailed product features in a carousel format.

You can also upload an image for each product category. This is a useful feature if you don’t have an image for each one of your products.

In the app, a product’s image is shown based on the following priorities:

  • The product’s primary image or (, if there’s no product image ) then

  • The product’s category image or

  • Your business logo if none of the above are uploaded.

Note

Refer to the recommended image sizes in the Appendix, accessible here.

See the Product Catalogue manual for more information about products, categories and the AI tool.

Order Catalogue

Status
colourBlue
titleoptional

Navigate to Commerce> Order Catalogues to configure an Order Catalogue to display products using your preferred categorisation. If an Order Catalogue is not set up, the you must assign Product Categories to display products in a categorised manner. Whether you choose to use the order catalogue or product categories, bear in mind that a maximum of 2 levels of categorisation are supported

When setting up an Order Catalogue:

  • Assign a meaningful name.

  • Give the catalogue categories descriptive names to help your contacts find what they want to order.

  • Optionally, upload an image for your Order Catalogue.

Info

The release app displays products using up to 2 category levels.

Business Network

Status
colourBlue
titleOptional

If your business is collaborating collaborates with other businesses (either within your internal Business Network structure or via B2B collaborations) or if your business has its own venues, then ensure that you keep these your partner’s and the locations and your own contact and location information up to date with some critical information that includes::

  • Address information with a latitude /longitude so that they can be pinpointed and longitude coordinates to accurately pinpoint locations on a map. This information can be used by helps contacts to locate the venue, and to promote their partners' aiding in the promotion of your partner's offers and promotions.

  • Phone number so your that contacts can get in touch.

  • Their opening hours, to facilitate the ordering flow (if used).

  • Images that Opening hours for ordering using the supply methods (e.g. delivery, pick up) offered by the location. When ordering is enabled, it is essential to set up the operating hours of the selling locations.

  • Images/logos that help contacts to identify the merchants.

  • The merchant’s Industry and Sub-industry. This information can be utilised to filter these merchants' reward offers within the app.

To manage your business network, navigate to Business Network > My Merchants/My Venues or Service Providers/Service Points. The Business Network manual will also help you understand its structure.

Reward Offers

Status
colourBlue
titleoptional

Set up your Reward Offers in the backend to award your contacts by navigating to Rewards > Offers.

Pay attention when setting up the following essential reward offer information:

  • Meaningful names and descriptions (provide a short and long description) for each offer.

  • Your offer’s Terms & Conditions.

  • Mark an offer as Featured to appear first in the list of offers.

  • Add Tags to your offers so as to allow easier filtering in the app.

  • Upload an image to promote it among other offers. If no image is provided, then your business logo will be used.

Reward Tiers

Status
colourBlue
titleoptional

A reward tier is assigned to your contacts based on their awards over a period of time. Within the app, contacts can view their tier level and what is required to maintain it or upgrade to the next tier. In Settings > Rewards > Tiering make sure you set:

  • A name for each tier,

  • A tier colour

  • A tier image - A tier’s image is not shown in CRM.COM’s release app. Upload an image when developing your own app.

Learn more about reward tiers here.

Promotions

Status
colourBlue
titleoptional

Set up your Promotions in the backend to give discounts to your contacts for their orders by navigating to Commerce > Promotions. When setting them up, consider the following essential information:

  • Meaningful names and descriptions (Short and Long description) for each offer. Ensure that these descriptions clearly explain how contacts can benefit from the promotion.

  • Add Tags to your Promotions to allow easier filtering in the app.

  • Upload an image to promote it, among other promotions. If no image is provided, then your business logo will be used.

Refer to the Promotions manual for more information.

Order Queues

Status
colourBlue
titleoptional

Set up your Order Queues to effectively manage the different stages of the ordering process. You can optionally, create a separate queue for each supply method (i.e. pick-up, delivery, direct sale). Note that at least one Order Queue is required if you enable the Orders module in the app settings.

To set up order queues Order Queues navigate to Settings > Commerce > Orders > Queues.

Fulfilment Policies

Status
colourBlue
titleoptional

Set up your Fulfilment Policies to manage ordering for your selected supply methods and state the acceptable payment methods for ordering. You can also set up one policy for each one of your collaborating partners.

You can create or edit the default fulfilment policy Order Fulfilment Policy via Settings > Commerce > Orders > Fulfilent Policies.

Service Request Queues

Status
colourBlue
titleoptional

Set up Service Request Queue(s) if you enable this feature on your app to allow your contacts to raise their own service requests. For each one of these queues, make sure you also set up the queue’s app settings. It should be noted that in the Note that in order for this self-service feature to work properly on the app, at least one Service Request Queue must be configured!

For each one of these queues, make sure you also set up the queue’s app settings. It should be noted that in the case of Service Requests, the app settings are configured within the service request Service Request queue’s detail page and not in the general App settings.

To set up service requests and queues navigate to Settings > Contacts & CRM > Service Requests > Queues.

Donation Offers

Donations

Status
colourBlue
titleoptional

Set up your Reward Offers Donations using a the Donation offer goal in the back-end system to enable your contacts to donate money from their CRM.COM Wallet to various charities. Navigate to Rewards > Offers to configure donations.

Make sure you set up the following essential information:

  • Descriptive name and descriptions (Short and Long description) for each donation offer. Ensure the descriptions provide details such as the donation amount and the charity that will receive the donation.

  • Upload an image to promote your donation offers. If no image is provided, then your business logo will be used.

Learn more about donations here. from their CRM.COM Wallet to various charities. Navigate to Rewards > Offers to configure donations.

Make sure you set up the following essential information:

  • Descriptive name and descriptions (Short and Long description) for each donation offer. Ensure the descriptions provide details such as the donation amount and the charity that will receive the donation.

  • The Donation’s Terms & Conditions

  • Upload an image to promote your donation offers. If no image is provided, then your business logo will be used.

Learn more about donations here.

Automations

Status
colourBlue
titleoptional

If your app supports ordering, you may want to set up the following automations:

  • Order provisioning for delivery orders - Configure an automation to define how delivery orders are assigned and managed. This could be based on proximity to the fulfilling location or by postcode area.

    • Trigger Event: New Order

    • Adaptor:CRM.COM Order Provisioning

    • Actions:

      • Fulfilled by Nearest Location: Specify a coverage radius (in kilometres) for each location.

      • Fulfilled Based on Postcode Coverage: Define the postcodes served by each location.

  • Create a Purchase Event for an Invoice - This setup is essential if you plan to use reward offers to award your contacts. A Purchase Event must be generated whenever an Invoice is issued to ensure contacts are awarded appropriately.

    • Trigger Event: New Invoice

    • Adaptor:Customer Events Provisioning

    • Action: New Purchase Customer Event

Integrations

Status
colourBlue
titleoptional

Enhance your app by configuring the following integrations.

  • Google Places- To allow exact address locations to be specified.

  • Payment Gateways - Either enable the CRM.COM Wallet Gateway for payments and topping up the CRM.COM Wallet, or setup your own integrationsPayment Gateway through Platform > Integrations. Also, refer to the Integrations manual for more information.

  • Communications- So that the business can send communications.

    • Email and/or SMS

    • Push Notifications (mobile apps only)

Info

Languages

The default app language is English, with Greek translations readily available. For other languages, please contact CRM.COM at support@crm.com.

Navigate to Platform > Integrations to set them up. Also, refer to the Integrations manual for more information.


Sample Screens

These screenshots demonstrate how the app settings and the various featured configurations are reflected in the app.

The Landing Page

image-20241007-132446.png

The Home Screen

image-20241004-135040.png

Reward Offer Screen

image-20241004-135120.png

Appendix

APPENDIX

Recommended Image Sizes

These are the recommended specifications for all images that will appear on the app.

Note

Please follow the required specifications before uploading an image. The specifications for each image are also available on the user interface.

Image

Format

Aspect Ratio / Dimensions

Max. Size

Landing page’s background image

jpg, jpeg, svg, or png

1:2

5MB or less

Business logo

jpg, jpeg, svg, or png

Background opacity, preferably transparent (0%)

1:1 /

500 x 500 pixels

5MB or less

Logo of Merchants/Venues

jpg, jpeg, svg, or png,

Background opacity preferably transparent (0%)

1:1

512 x 512 pixels

5MB or less

Carousel

jpg, jpeg, svg, or png

21:9

5MB or less

Embedded browser links

jpg, jpeg, svg, or png,

1:1

128 x 128 pixels

5MB or less

Reward Offers

Promotions

Donations

jpg, jpeg, svg, or png

16:9

5MB or less

Products

Product Categories

jpg, jpeg, svg, or png

1:1 / 500 x 500 px.

5MB or less

Reward Offer Tiers

jpg, jpeg, svg, or png,

1:1

128 x 128 pixels

5MB or less

Table of Contents
minLevel1
maxLevel6
outlinefalse
stylenone
typelist
printabletrue