Technical architecture

What would need to be built for this to be real

The prototype simulates every external system. This page separates what is genuinely hard from what is configuration, and states the one hypothesis the economics depend on.

Customer signalsNeedApproved relationshipPermitted actionOutcome

What AI does, and what people and rules decide

AI interprets customer signals. Product rules and people decide what can happen next.

AI interprets customer reality. Product policy determines what commercial action is allowed.
AI does this
  • Interpret unstructured and semi-structured partner context
  • Synthesize events across delivery, billing, CRM and document metadata
  • Map observed changes to candidate customer needs
  • Generate human-readable reasoning and evidence summaries
Deterministic product policy does this
  • Which commercial relationships are approved
  • Which destinations are eligible for a given need
  • Which fields may be shared, and with whom
  • Which actions are allowed, and who must approve them
  • Whether an opportunity already exists, and whether to suppress

Decision logic

How Vinculo gets from customer signals to an action a partner can approve

1
Need inference
Customer signals
Approved signals from the systems the partner already uses, such as CRM, delivery, billing, account activity, and scope changes
Need inference
AI looks across approved customer signals and identifies a possible need, with the evidence kept so a person can understand why
Need confidence
How much independent evidence supports the need, using the partner's own rules
2
Destination fit — evaluated separately
Inferred need
Output of stage 1, independent of any destination
Approved destination relationships
Domain coverage, segment, geography, commercial model
Destination fit
Strong / Possible / Weak, based on the inferred need and configured destination criteria
3
Permitted commercial action
Destination fit
From stage 2
Permission rules
What may be shared, and who approves
Existing pipeline
Destination CRM check for a live opportunity
Partner economics
Referral, reseller, or no permitted action
Permitted commercial action
Surfaced with a prepared action — or suppressed, with a recorded reason
Product hypothesis

If many destination companies use a small number of common systems, Vinculo may be able to reuse the same integration work across multiple relationships.

The key question is whether adding the next destination is mostly setup, or another custom technical project.

Falsification condition

If every destination needs substantial custom technical work, the multi-relationship model becomes much harder to scale.

System layers

These are the things the full product may need to do. They do not all need to be built for the first pilot. The First 120 Days section shows what can start manually or with lightweight tools.

1. Connect to approved partner data

Build
  • Read-only access to the systems the partner already uses, such as CRM, delivery, documents, and billing
  • Optional, opt-in communication sources, used only as supporting evidence
  • Clear limits on what is read, and a record of what was read

Open question: does the variety of partner systems create more work than the variety of destination systems?

2. Customer signal record

Should be reusable
  • Signals from different systems need to be understandable together.
  • Each signal should be tied to the right customer.
  • The original source should always be traceable.

Keep customer signals in a consistent, easy-to-review format, tied back to where each signal came from.

3. Need inference

Build
  • AI looks across approved customer signals and identifies a possible need, with the evidence kept so a person can understand why
  • Evidence is grouped as primary, supporting, or corroborating
  • AI interprets customer signals. Product rules and people decide what can happen next.

A new partner has no history to learn from, so the first rules have to make sense on their own.

4. Need confidence

Build
  • How much independent evidence supports the need
  • Partners can set their own evidence rules
  • Low confidence stops the process before any destination is considered

Confidence has to be explainable to a partner, not a hidden score.

5. Approved commercial relationships

Should be reusable
  • Which destination companies are approved.
  • What type of need each one can help with.
  • What kind of commercial relationship exists.
  • What action is allowed.

This information has to stay current or the recommendations get worse.

6. Destination fit

Build
  • Is this destination actually a good fit for the need?
  • Use Strong / Possible / Weak.
  • A real need can still result in no action if the fit is weak.

If Vinculo recommends weak matches too often, partners will stop trusting it.

7. Permissions and partner rules

Should be reusable
  • What can be shared.
  • Who needs to approve.
  • Which actions are allowed.
  • The partner can override or stop an action.
  • Access to data and permission to act are not the same thing.

Legal and data-sharing rules need to be clear before this can run in production.

8. Destination pipeline check

Reuse to test
  • Check whether the destination already has an active account or opportunity.
  • Avoid creating duplicate activity.
  • Suppress the recommendation if the opportunity already exists.

In the full product this may require access to the destination's system. In an early pilot, the same check can be done manually or with a simple lookup.

9. Prepare and manage the action

Build
  • Prepare the action and draft message.
  • Track whether it is reviewed, approved, sent, changed, or stopped.
  • Avoid sending the same action twice.

If something fails halfway through, Vinculo should not accidentally create the same action twice.

10. Deliver into the partner's workflow

Build
  • Send the action into a place the employee already checks.
  • This could be CRM, email, Slack, Microsoft Teams, or another workflow.
  • The employee should not need to monitor a separate Vinculo inbox.
  • The delivery method can vary by partner.

Open question: how much work is needed to support each delivery option?

11. Send the action to the destination

Reuse to test
  • Check the destination's existing pipeline.
  • Send or create the approved action.
  • Get enough outcome information back to know what happened.
  • Salesforce and HubSpot are examples of destination systems.

Open question: if two destination companies use the same system, how much of the work can be reused?

12. Track what happened

Build
  • Was the referral accepted?
  • Was an opportunity created?
  • Did the meeting happen?
  • Did the opportunity move forward?
  • Tie the outcome back to the original Vinculo action.

Vinculo only gets better if it can see enough of what happened after the action.

13. Learning and suppression

Build
  • Capture why a partner approves or dismisses something.
  • Turn repeated feedback into clearer rules.
  • Hold back similar recommendations when a partner has already shown they are not useful.
  • Explicit partner knowledge can override an inferred recommendation.

Early on, there may not be enough feedback to train a strong model, so simple rules and human review matter.

Data boundary

Applied in one place, not per integration

Can be shared
  • Prospect identity
  • Partner identity
  • Approved need summary
  • Approved commercial context
  • Partner-approved message
Does not leave the partner
  • CRM notes
  • Project details
  • Source documents
  • Communications
  • Raw customer data

The evidence stays with the partner. Only the approved summary can move.

One decision, many delivery options

  • Partner A → CRM card
  • Partner B → Microsoft Teams
  • Partner C → email
  • Partner D → CRM task

The same Vinculo logic can sit underneath. The delivery method can change based on how each partner works.

These are examples. The exact technical approach is still open.

Explicit non-goals

Things this prototype deliberately does not do

  • No real sign-in or billing in this prototype
  • No purchased third-party intent data
  • No raw customer data, documents, or messages sent to destinations
  • No invented deal values
  • No action taken outside the partner's approval

The examples on this page show possible ways the product could work. The CTO should determine the best technical approach. What matters here is the behavior, permissions, boundaries, and information that need to move between systems.