User Guide

Run auditable customer satisfaction surveys directly from Business Central.

CustomerFlow supports the full survey cycle: identify the relevant customers, send multilingual invitations, collect responses through a branded web form, and evaluate the results directly in Dynamics 365 Business Central. The solution is designed for companies that want a structured, repeatable process for ISO 9001:2015 customer satisfaction measurement.

Good to know

CustomerFlow consists of two parts: the Business Central extension and a small external PHP web application that hosts the survey form and API. The Business Central app manages the business process; the web application handles the public survey link, branding, and secure response collection.

Prerequisite

Before users can answer surveys online, the CustomerFlow web component must be installed and configured, and the Business Central setup must contain the correct Survey Web Form URL and Web API Key.

Getting started

Installation

Install the extension directly from Microsoft AppSource within Dynamics 365 Business Central.

  1. 1
    Open Dynamics 365 Business Central search.

    Use Alt+Q to open Tell Me and search for Extension Marketplace.

  2. 2
    Find CustomerFlow.

    Search for the app, open the marketplace entry and choose Get it now.

  3. 3
    Complete installation.

    Follow the standard Dynamics 365 Business Central prompts.

    Important: Allow HttpClient Requests

    Because this app requires internet access to communicate with external web services, you must allow it to make HTTP requests. Depending on your version of Business Central, you may be able to check the box for Allow HttpClient Requests directly during the installation dialog. Otherwise, you must manually enable it afterwards by going to the Extension Management page, selecting CustomerFlow, and choosing Configure.

    Allow HttpClient Requests toggle in Dynamics 365 Business Central
First steps

Set up CustomerFlow

After installation, open the CustomerFlow setup page in Business Central and connect the extension to your survey web server.

Open the setup page

Use Alt+Q in Dynamics 365 Business Central and search for Customer Satisfaction Survey Setup. This page contains the complete configuration for numbering, language fallback, and web integration.

  • Survey No. Series defines the numbering of survey campaigns.
  • Default Language Code is used when no matching email template exists for the customer's language.
  • Auto-excl. Blocked Customers automatically skips blocked customers during entry creation.

Connect the web form

In the Web Form area, fill in the integration values from the CustomerFlow web application:

FieldPurpose
Survey Web Form URLThe public survey URL, for example https://survey.yourcompany.com/survey. This link is inserted into the survey email.
Web API KeyThe API key generated by the web application admin panel. It secures communication between Business Central and the web server.
Last Response PollShows when Business Central last checked the web server for completed responses.

Use the setup actions

The setup page provides several actions to validate and automate the integration:

ActionWhat it does
Email TemplatesOpens the multilingual email template list for survey invitations.
Test ConnectionCalls the web API and verifies that the server and API key are configured correctly. The company name is sent as well and can initialize the branding on the web server.
Setup Queue JobCreates a Job Queue Entry that processes the integration queue and polls for completed responses every 5 minutes.
Poll Responses NowImmediately checks the web server for completed responses and imports them interactively.
Queue EntriesShows the technical queue used for register, close, reopen, delete, and polling operations.
Core workflow

Run a survey campaign

CustomerFlow is organized around survey campaigns. Each campaign defines an evaluation period and contains the individual customer entries that will be contacted.

  1. 1
    Create a new survey.

    Open Customer Satisfaction Survey, create a new record, add a meaningful description, and define the evaluation period. By default, many teams use the previous calendar year.

  2. 2
    Populate entries.

    Use Populate Entries to automatically find customers with posted sales invoices in the selected period. CustomerFlow calculates invoice amount, credit memo amount, and contact information from recent invoice activity.

  3. 3
    Review and complete the entry list.

    Check email addresses, language codes, and contact persons. Add or remove entries if needed before sending.

  4. 4
    Send survey emails.

    Use Send Survey Emails to register each token on the web server and send the invitation email with the personalized survey link and PDF attachment.

  5. 5
    Collect responses.

    Customers answer the survey in the browser. Completed responses are imported automatically through the queue job or manually via Poll Responses Now.

  6. 6
    Evaluate the results.

    Use the Survey FactBox, survey entries, and customer FactBox to review response rate, average score, and detailed ratings.

The built-in questionnaire

CustomerFlow uses a fixed questionnaire with eight rating questions and one comment field. This ensures a consistent evaluation basis across all campaigns.

QuestionAnswer type
Overall satisfaction with our cooperation1-5 stars
Quality of products / services1-5 stars
Delivery reliability and adherence to deadlines1-5 stars
Availability and response time1-5 stars
Friendliness and competence of our staff1-5 stars
Value for money1-5 stars
Complaint and claims handling1-5 stars
Likelihood of recommending us1-5 stars
Additional comments and suggestionsFree text
Communication

Email templates and placeholders

CustomerFlow includes ready-to-use templates in German and English. Templates are maintained directly in Business Central with an integrated HTML editor.

Template structure

Each template consists of a Language Code, an email Subject, and a rich HTML body. The HTML body is edited through the built-in TinyMCE editor, which supports placeholder insertion for dynamic values.

If a customer's language does not have a dedicated template, CustomerFlow falls back to the Default Language Code from the setup page.

What is sent to the customer

The invitation email typically contains:

  • A personalized subject and body text.
  • A direct, token-based link to the online survey form.
  • A PDF attachment of the survey document.
  • The customer's own language where available.

Available placeholders

PlaceholderReplaced by
{CustomerName}The customer name
{CustomerNo}The customer number
{ContactName}The selected contact person
{EmailAddress}The recipient email address
{BatchDescription}The survey campaign description
{PeriodStart}The evaluation period start date
{PeriodEnd}The evaluation period end date
{SurveyLink}The personal survey URL including token

Best practice

Keep the email wording short and personal. Explain why the customer is receiving the survey, how long it takes, and what you do with the feedback. This usually improves the response rate.

Operations

Manage survey entries and responses

Each customer in a campaign is represented by a survey entry. This entry tracks the invitation status, dates, average score, and the individual answers.

Key fields on the entry

  • Customer No. and Customer Name
  • Contact and Email Address
  • Language Code
  • Status, Sent Date, and Response Date
  • Average Score and the detailed answers for Q1-Q9

Contacts can be selected directly from the customer's linked company contacts in Business Central.

Status values

StatusMeaning
CreatedThe entry exists but no invitation has been sent yet.
SentThe email has been sent and the token is active on the web server.
CompletedA response has been recorded, either from the web form or manually in Business Central.
CancelledThe entry was intentionally stopped and should no longer be answered.

Available actions

ActionWhat it does
Resend EmailRe-sends the invitation to selected entries, regardless of their current status.
Record ResponseMarks the entry as completed and stores the current values on the response fields. Use this when the customer answered by phone, mail, or during a personal conversation.
ReopenChanges a completed entry back to an editable state and reopens the corresponding token on the web server.
CancelStops the entry and closes the corresponding token so the customer can no longer submit the survey.

Manual response entry

The entry card allows direct maintenance of Q1-Q9 while the survey is still editable. This is useful when feedback is collected outside the web form. The average score is then calculated from the answered rating questions.

Web application

How the external survey form works

The CustomerFlow web component is the public-facing part of the solution. It receives survey tokens from Business Central, renders the branded form, and returns completed responses through a secure API.

Customer-facing survey form

The survey form is opened through a personal token link. Customers do not need a Business Central login.

  • Responsive layout for desktop and mobile browsers
  • Star rating for questions 1-8
  • Free-text comment field for question 9
  • Validation that requires at least one rating or comment
  • Thank-you page after successful submission
  • Invalid page for expired, closed, or unknown tokens

Admin panel

The web application contains an admin area for maintaining the public survey experience and web integration settings.

  • Dashboard with overall survey statistics and latest responses
  • Branding for company name, logo, colors, and welcome texts in German and English
  • Settings for API key display/regeneration and password maintenance
  • Password reset and email verification for the web admin user

API lifecycle between Business Central and the web server

Integration stepPurpose
Register survey tokenWhen an invitation is sent, Business Central registers the token and campaign metadata on the web server.
Poll completed responsesThe queue job retrieves completed surveys from the web API.
Mark as fetchedAfter import, the response is marked as fetched to avoid duplicate import.
Close tokenCompleted or cancelled entries can be closed on the web server.
Reopen tokenA completed survey can be reopened when a correction is needed.
Delete tokenIf an entry is removed in Business Central, the corresponding web survey can be deleted as well.
Analysis

Review survey results

CustomerFlow keeps the evaluation close to the operational data. Results are visible on the survey itself, on individual entries, and on the customer card.

Survey FactBox

The survey card shows a compact KPI view:

  • Total Entries
  • Sent
  • Responses
  • Response Rate
  • Avg. Score

This gives quality management an immediate overview of campaign progress and participation.

Customer FactBox

On the customer card, the latest survey result can be displayed with:

  • Survey number
  • Status
  • Sent date and response date
  • Average score
  • Q1 overall satisfaction
  • Q8 recommendation

This lets sales or account managers see recent satisfaction feedback without opening the full survey history.

Interpretation of the average score

The Average Score is calculated from the answered rating questions Q1-Q8. Unanswered rating questions are ignored rather than counted as zero. This helps preserve a fair average when a customer answers only part of the questionnaire.

Recommendations

Best practices for daily use

CustomerFlow works best when the process is treated as a recurring quality workflow rather than a one-time mailing action.

For quality management

  • Run surveys on a clear cycle. Annual campaigns are common, but the process also supports quarterly or project-based surveys.
  • Review the entry list before sending. Especially check contact names, email addresses, and language codes.
  • Track response rate early. If the rate remains low, resend selected entries after a reasonable waiting period.
  • Document follow-up actions. Negative feedback becomes more valuable when corrective actions are tracked internally.

For administrators

  • Test the connection after changes. Whenever the web URL, API key, hosting, or SSL configuration changes, run Test Connection.
  • Keep the queue job active. Automatic polling is essential for near-real-time response import.
  • Protect the API key. If you suspect it has been exposed, regenerate it in the web admin panel and update the setup page immediately.
  • Use branding consistently. A professional survey page with logo and welcome text increases trust and participation.

Permissions

Users need permission to access the CustomerFlow pages and the related customer, contact, and email functionality in Business Central. In practice, this is typically handled through the delivered CustomerFlow permission set and the normal email permissions used in your tenant.

Questions & answers

Frequently asked questions

Does CustomerFlow require an external survey website?

Yes. The public questionnaire and the API run in the CustomerFlow web application. Business Central alone does not host the public survey form.

Can responses be entered manually?

Yes. Survey entries can be completed directly in Business Central and then marked as responded. This is useful for phone interviews, trade fair conversations, or paper forms.

How often are web responses imported?

The queue job is designed to poll the web server every 5 minutes. You can also trigger an immediate import with Poll Responses Now.

Can a completed survey be reopened?

Yes. Use the Reopen action on the survey entry card. CustomerFlow reopens the entry in Business Central and sends a reopen request to the web server.

What happens if the web server is temporarily unavailable?

CustomerFlow uses an internal queue for integration steps such as token registration, close, reopen, and delete. If a direct call fails, the request is queued for retry later.

Which languages are supported?

The delivered templates and web application support German and English. The Business Central setup also contains a default language fallback for cases where no exact template match exists.

Is CustomerFlow suitable for ISO 9001:2015 documentation?

Yes. The product is designed to support a standardized and documented customer satisfaction process, including repeatable questionnaires, response tracking, and result analysis in Business Central.

Support & Feedback

We are here to help

Whether you have technical questions, need guidance during your rollout, or want to share feature requests — our dedicated Dynamics 365 Business Central team is ready to assist you. Drop us a message, and we'll ensure you get the absolute most out of our apps.