Skip to main content
The SIGAVI 360 integration connects your SIGAVI to Play2sell for three things:
  • Missions — activities, visits, and events that brokers record in SIGAVI count toward the gamification missions.
  • Leads — each SIGAVI service record (FAC) becomes a lead in Play2sell, with the responsible broker and the funnel stage.
  • Commission Payments — the commission of each SIGAVI proposal becomes a sale in Play2sell PAY: each boleto awaiting payment is charged and the transfer is split among the beneficiaries. See the Commission Payments section further below.
Setup is done screen by screen, with no coding, and takes about 10 minutes. Commission Payments is turned on in stages: first in observation mode, on the same screen, and only then live.
SIGAVI is the source of truth. Play2sell only reads your SIGAVI — nothing is created, changed, or deleted there. The read happens every 10 minutes: what the broker records in SIGAVI appears in Play2sell within 10 minutes.

What you’ll set up

Prerequisites
  • Be an administrator of the company in Play2sell (only administrators turn the integration on or off).
  • Have your SIGAVI’s integration user — it is the API user, not your personal login.
  • Nothing to register by hand: the SIGAVI collaborators are imported as users (the Usuários (Users) block, which comes turned on).

How does the integration work?

1

The broker works in SIGAVI

They record activities, visits, and service records as they always have.
2

Play2sell reads what changed

Every 10 minutes Play2sell queries your SIGAVI and brings in what was created or changed since the previous read. Each read steps back a few minutes over the previous one, so as not to miss anything that was saved along the way — whatever comes in repeated is recognized and does not count twice.
3

Activities count toward missions

Each activity, visit, or event is attributed to the broker who recorded it and becomes available to your company’s missions.
4

Records become leads

Each service record becomes a lead. When the record changes situation in SIGAVI, the lead follows, moving to the funnel stage you chose.

How the broker is identified

A record whose broker is not found generates no points, and the lead is assigned to an active user of the company — reassign it in Play2sell if needed. To avoid this, leave Usuários turned on: the SIGAVI collaborators enter Play2sell with the same email and the same CPF.
If the same person is registered twice in Play2sell (once with the email, once with the CPF), the record goes to the registration found by email. It is worth merging duplicate registrations before connecting.

Which day an activity counts on

Each activity counts on the date and time it was registered in SIGAVI — in practice, the moment Play2sell reads it, up to 10 minutes later. Dates entered by the broker, such as the date set for a task, do not change the day: a task scheduled today for Friday counts today. Missions always apply to the present; nothing counts toward a past or future day.

Accounts left out of the ranking

SIGAVI accounts that are not brokers — the system vendor’s support, test accounts — also register activities. To keep their activities out of the missions, open Edit configuration and, with Missions on, use Accounts left out of the ranking: enter the account’s email and save. The screen also lists accounts with activity in the last 7 days and no user here, with a Leave out button. To bring an account back into the ranking, remove it from the list.

Step 1 — Get the integration user in SIGAVI

The connection needs three values: address, integration user, and password.
1

Open your SIGAVI's API help

With your administrator login, go to yourcompany.sigavi360.com.br/Help (replace yourcompany with your SIGAVI’s address).
2

View the integration credential

On the help page, use the option to view the integration user and password and copy both values.
3

Note the address

It is the part before .sigavi360.com.br — in yourcompany.sigavi360.com.br, the address is yourcompany.
You have address, integration user, and password in hand.
The integration password is sensitive — treat it like any password. In Play2sell it is stored and never shown again. If you can’t find the integration credential in the SIGAVI help, ask SIGAVI support for your company’s API user.

Step 2 — Connect in the Play2sell panel

In the Play2sell panel, go to Integrações → Conectores (Integrations → Connectors), find SIGAVI 360, and click Conectar (Connect). When you click Continuar (Continue), Play2sell checks the access on the spot in your SIGAVI. If the user or the password doesn’t get in, you see the reason right there and nothing is saved.

Step 3 — Choose what to turn on

After checking the access, the panel shows what can be turned on: You can turn on all of them or just some. With Usuários turned off, leads and activities are only attributed to those who already have a registration in Play2sell with the same email.

Funnel stage for each situation

With Leads turned on, the panel lists your SIGAVI’s service situations — read from your account, with the names your company uses — and, next to each one, the stages of your lead funnel in Play2sell.
  • When there is a stage with the same name as the situation, it comes already selected.
  • For the others, choose the stage — or leave “Manter a etapa em que o lead está” (Keep the stage the lead is in).
Click Conectar. The first read goes out within 10 minutes; sales are read every 30 minutes.
You don’t need to map everything at once. You can come back later, in Editar configuração (Edit configuration), and adjust the stages — the choices already made come filled in.

Step 4 — Check the first read

1

Wait up to 10 minutes

The first read brings in the records changed in the last 24 hours, the activities from the last 2 hours, and the sales from the last 48 hours. Anything older than that is not imported.
2

Check a lead

Open the lead funnel and look for a recent service record from SIGAVI: name, contact, responsible broker, and stage should match.
3

Check an activity

Ask a broker to record an activity in SIGAVI and, after 10 minutes, see their progress in the missions.

What is read from SIGAVI

What the lead receives

What the user receives

Collaborators without an email in SIGAVI are not imported. Not imported from the collaborator: parents’ names, RG, marital status, children, sex, place of birth, previous company, education, and the SIGAVI login.

Lead rules

  • One record, one lead. If the same record is read again, the lead is updated — it is not duplicated.
  • Name and contact come from SIGAVI. A field that arrives empty from SIGAVI does not erase what is already on the lead.
  • SIGAVI updates what it sends. Name, contact, document, expected close date and extra fields with the same name are updated on each read whenever SIGAVI has a value. The amount and other data filled in only within Play2sell stay.
  • Deletions are not mirrored. A record deleted in SIGAVI remains as a lead in Play2sell.

Commission Payments

With Commission Payments, the commission of each SIGAVI proposal is charged to the payer by Play2sell PAY, and the amount received is split among the beneficiaries (broker, agency, manager…) exactly as it is in SIGAVI.
Turned on in stages. Commission Payments always starts in observation mode, which you turn on yourself on the connection screen: Play2sell reads and checks your proposals without issuing or paying anything, and shows what would be ready and what needs fixing. Going live is a second step, done with the Play2sell team after you check the result.

How it works

1

You enter the commission in SIGAVI

On the proposal: the commission boletos (payer, amount, due date and beneficiaries) and each collaborator’s commission, with the position.
2

Play2sell reads and checks

Every 10 minutes Play2sell reads the boletos and commissions with an upcoming due date (from the last 30 days to the next 120), groups everything by proposal, and checks the proposal against the rules below.
3

The proposal becomes a sale in Play2sell PAY

A proposal that passes every rule becomes one sale, and each of its boletos awaiting payment becomes a charge (boleto with Pix) in the payer’s name. Each proposal is issued only once.
4

The payer pays

The amount is held in custody in Play2sell PAY.
5

The deed releases the transfer

When the proposal reaches the Escriturado status in SIGAVI, the transfer of what has already been paid is released and each beneficiary receives their share. A boleto not yet paid is released when it is paid. A proposal that was already deeded when issued has the transfer released as soon as the boleto is paid.

What needs to be in order

The Commission Payments roles are: Seller, Agency, House, Manager, Coordinator and Partner. The connection screen shows the positions your company uses in SIGAVI commissions, so you can choose the role of each one. The beneficiary is identified by CPF/CNPJ. Anyone not yet in your company in Play2sell is registered with the name and email from SIGAVI and linked to the company — there is no need to register them first.

Checking rules

Each rule applies to the whole proposal: if a boleto or a beneficiary does not pass, nothing from that proposal is issued — Commission Payments does not charge halfway.

Cancellation (distrato)

When the proposal reaches the Distrato produção status in SIGAVI:
  • an open boleto is cancelled;
  • a paid boleto still in custody is returned to the payer;
  • if the transfer has already been made, nothing is undone on its own: the case is recorded and handled with the Play2sell team.
A cancelled proposal that had not been issued yet is not issued.
If your company uses other status names for the deed and the cancellation, the Play2sell team adjusts the mapping for your company.

What Commission Payments does not do

  • It does not write to SIGAVI. The charge, the payment and the transfer appear in the Play2sell panel; SIGAVI is not updated.
  • It does not change what has already been issued on its own. If the proposal changes in SIGAVI after being issued (amount, due date, beneficiaries), nothing is reissued automatically: the change is recorded and handled with the Play2sell team. The exception is the cancellation, above.

How to activate

1

Connect SIGAVI

Steps 1 and 2 on this page. Commission Payments uses the same connection.
2

Turn on Commission Payments in observation mode

In Integrations → Connectors → SIGAVI 360, in the what to turn on step, turn on Pagadoria de comissões, choose the role of each position and save. Nothing is issued: reading your proposals starts within 10 minutes.
3

Check what observation shows

Go back to Edit configuration: the screen shows the last read — how many proposals were read, how many would be ready and why the others would not pass. In Integrations, the integration health panel lists each proposal with the decision and the reason. Fix the registrations and the map until the result is as expected.
4

Ask to go live, with low limits

With observation checked, the Play2sell team turns on issuing for your company, with an amount cap per proposal and a maximum number of proposals per read defined with you.
5

Check the first sale

After checking the first charge issued and the first transfer, the limits are raised.

Edit or turn off

In Integrações → Conectores → SIGAVI 360 → Editar configuração:
  • Review the configuration: enter the integration password again (it is not visible after being saved), adjust whatever you want, and save.
  • Reimportar as fichas dos últimos 7 dias (Re-import the records from the last 7 days): turn on this switch so that the next read re-reads the records from the period and completes the leads that have already come in. Nothing is duplicated.
  • Desligar integração (Turn off integration): the reads of records, activities, sales, and users stop. Commission Payments has its own switch: to stop it, turn off Pagadoria de comissões in the what to turn on step. Leads and points that have already come in remain in Play2sell, and you can turn it on again whenever you want — the read resumes from where it stopped.

Frequently asked questions

Within 10 minutes. SIGAVI does not notify when something changes, so Play2sell queries every 10 minutes.
No. The integration is read-only.
Only if the record’s situation in SIGAVI has a stage chosen in the mapping — in that case SIGAVI rules. If the situation is set to “Manter a etapa em que o lead está”, the lead stays where you put it.
Records in that situation keep becoming leads, and the lead stays in the stage it is in. To direct it to a stage, open Editar configuração: the new situation appears in the list.
No. The integration starts counting from the connection (with the windows from Step 4).
No. Each SIGAVI record has its own identification; what is read again is recognized and ignored.
Yes. On the first read, the new type is added to the Missions activity list with the same name it has in SIGAVI, and you can use it in a mission. It only counts once it is part of an active mission.
No. Commission Payments comes turned off. When you turn it on on the screen, it starts in observation mode (without issuing or paying); issuance only goes live after you check the result and ask for it to be turned on.
No. Each SIGAVI proposal has its own identifier and is issued only once, even though it is read again every 10 minutes.
Nothing is reissued on its own. The change is recorded and the Play2sell team handles the case with you. The exception is the cancellation: open boletos are cancelled and paid ones still in custody are returned to the payer.
No. The beneficiary is identified by CPF/CNPJ and, if not yet in your company, is registered with the name and email from SIGAVI.
When the proposal reaches the Escriturado status in SIGAVI and the boleto is paid. If the proposal was already deeded, as soon as the boleto is paid.
No. SIGAVI does not offer a way to receive that information; tracking is in the Play2sell panel.

Troubleshooting

Commission Payments — why a proposal was not issued

Reference