Connect Planfix
Planfix keeps customer contacts, conversation tasks, statuses and notes together. For example, an agent can create a sales task for a new enquiry and keep its conversation summary up to date.
Use a paid Planfix account. You need a dedicated Short text task field to prevent duplicate tasks; Versafy can create it for you, or you can create it manually. A Number field is needed only for order totals. Both fields must be on the selected task object’s Card and editable by the connected Planfix user. A task creation template is optional; older accounts may use its form instead of an Object Card.
Versafy preselects fields and templates using their types and names, including Russian names such as Бюджет and Шаблон контакта. Review the selections and change them if needed; ambiguous matches remain unselected. To enable a new field, open the selected task object under Custom in Types of objects, then Card. The Task entry under System has no Card page.
Choose Task object (e.g. Deal) separately from the Task creation template (optional). The object defines where tasks appear and which fields are on their form; the template only supplies creation defaults. Leave the template Not configured if no template belongs to your selected object. Review the object choice and enable the mapped fields on its Card. The token needs object_readonly to list objects. A tutorial template is not selected just because it is the only template.
If Planfix warns that adding the external ID field would remove the object’s existing fields, cancel. In Account management → Custom fields → Task fields, select the external ID field and use Transfer to field set to move it to Main. Then add it to the selected object’s Card without removing the existing fields, and retry saving the connection.
To change mappings later, open an agent’s CRM tab → Planfix field mappings. Select the task object, external ID field, amount field, task/contact templates, and the Planfix employee for new tasks. Choose Save mappings; the setup check runs automatically before saving. You do not need to reconnect or enter the token again. These settings apply to every agent using that CRM connection and require permission to manage integrations. Reload options fetches the latest fields and saved selections.
The page checks saved mappings when it loads and shows a warning if a selected field is missing from the Object form or another setup check fails. Correct the selection and choose Save mappings again. If the amount field cannot be used, select Not configured; order totals will not sync until a valid number field is selected.
Select the employee who should open new tasks in Planfix. Versafy assigns new tasks to that employee. The automatic setup check verifies the selected employee is active, the external ID and amount fields are available on the chosen Object form (or legacy template form), and the template belongs to the selected object. It does not test your browser session or create a task, so open a newly synced task in Planfix after connecting. Contact visibility is controlled separately by the contact template’s permissions in Planfix; review those permissions if contacts do not open. Existing tasks and contacts keep their current access.
Create and enable fields
For manual field creation, open Planfix Account management → Custom fields → Task fields. Create a Short text field with a distinct name, such as Versafy external ID, in the Main field set. Then use Back / reload options in Versafy and select it by name. Do not reuse a field that stores other data.
After either automatic or manual creation, finish these steps in Planfix: open Account management → Types of objects → Custom → your selected object → Card, add the external ID field from Main, and save while keeping the existing fields. Add the selected numeric amount field to the same Card if you use one. Next, open each field under Account management → Custom fields → Task fields and grant view and edit access to the Planfix user associated with the REST token. This may be a different person from the employee receiving new tasks. Automatic creation selects the field in Versafy, but adding it to the Card and granting access are always manual steps.
Connect and validate
To prepare the token, open Planfix Account management → API Access → REST API, create or edit a token, and add the scopes shown in Versafy under Allowed Scopes. In the connection form, enter your Planfix Account URL and REST API token, then follow the steps below.
- Choose Planfix in the CRM connection dialog.
- Under Required API permissions, grant the listed runtime permissions in Planfix. Include
custom_field_addif you want Versafy to create the external ID field; it is optional when choosing an existing field. Copy all includes it. - Enter the connection details and select Continue to load the available fields and templates. Choose your dedicated External ID field by name; do not select a field used for other data.
- If you need a new field, select Create new… in the External ID field dropdown. This creates and selects a dedicated field in the Main field set. Before connecting, add that field to the task Object form and grant the connected user edit access. If creation fails, the popup explains how to grant the permissions or create the field manually, then reload the options. Existing tasks are not changed or automatically matched; syncing records already entered manually can create duplicates.
- Open Advanced settings only if needed: choose an Amount field (optional) for order totals and add that numeric field to the selected object’s Card. Leave it Not configured if you do not sync order totals. Choose a task creation template only if it belongs to the selected object; contact templates are separate. Loading options does not create records or save a connection.
- Select the Planfix employee for new tasks, then Connect Planfix. If the setup check reports a field, template, or employee issue, resolve it and try again. Then choose the process and status in the agent’s CRM tab. Credential replacement uses the same steps; select the intended mappings again before saving.
A standard process may appear by its numeric ID. Contact updates, editable conversation notes and order amounts are supported. CRM chat, file uploads, tags, reuse of an existing open task and native delivery fields are unavailable. Field-creation permissions are not needed for normal operation. If access is denied, check both the Object form and the connected user’s field-edit permissions.
To choose who appears as the author of new Planfix comments, open Advanced settings → Comment author (optional) during connection setup. You can also change Comment author (optional) in the agent’s CRM → Planfix field mappings without reconnecting. API token user keeps the token owner as author. Selecting another employee does not change task assignment, and existing comments keep their author. This setting is shared by all agents using the connection.
Task stages
The selected Task object defines the available Planfix stages. Versafy shows that object’s name as its process; statuses from an unrelated tutorial template are not used. After changing objects, review the process and status in the agent’s CRM tab.
For stage-changing tools, open CRM Application Tools on the agent’s AI Reply tab, choose Refresh Schema, then Configure Allowed Stages. Review the stages and save the ones the agent may use. Refreshing does not automatically allow new stages.
If a desired stage such as On hold is missing, add it in Planfix under Account management → Types of objects → Custom → your object → Status set → Add status to set, and configure the permitted transitions. Then refresh the stages in Versafy and allow that stage. The agent cannot move a task to a status absent from its object or silently substitute a different outcome.