Contexto da empresa, canvas por canvas
const url = 'https://developers.nexo.winningsales.com.br/v1/company/context';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://developers.nexo.winningsales.com.br/v1/company/context \ --header 'Authorization: Bearer <token>'Os sete canvases do contexto da empresa (empresa, ICP, persona, proposta de valor, posicionamento, oferta e prova), campo a campo, com a origem de cada campo e se a empresa já confirmou. É o mesmo contexto que o Nexo usa nas leituras; ler não consome IA.
Authorizations
Seção intitulada “Authorizations”Responses
Seção intitulada “Responses”Os sete canvases
object
The latest site reading; null when none was requested yet
object
Reading id
Status of the latest site reading
Ai_unavailable = try again; ai_rejected and budget = trying again does not help; unreadable = the answer came broken
Site that was read
ISO instant the reading finished
object
Empresa
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
Official company name
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
The supplier’s own activity, never the industries it serves
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Narrower description of the actual activity
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Size of the company itself; set by rule from an explicit headcount, never guessed
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
2 to 4 sentences: what the company does and for whom
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Tone-of-voice descriptors, comma-separated
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Canonical site, or empty
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Explicit service coverage; a headquarters address is not coverage
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Words the brand and buyers lean into
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Words that sound off-brand or create friction
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Points of view the brand publicly holds
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
ICP
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
Customer industries
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Customer organization size; empty when unknown
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Supported service coverage
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Events that put these customers in market
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Explicit anti-fit only
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Signs that a live opportunity fits
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Explicit conditions that make a live opportunity unsuitable
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Persona
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
object
Short, distinct, addressable handle
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Buying-role synonyms
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
What this person handles in relation to the offer
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Recurring friction the offer helps address
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Outcomes this audience seeks
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Factors compared when choosing
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Plausible concerns that could delay the decision
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Typical “why now” situations
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
The offer’s value through this persona’s needs
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Plausible places to reach this audience
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Working assumptions shaping the choice
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Risks this audience wants to avoid
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
A stated request paired with the underlying want
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Proposta de valor
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
One-sentence pitch
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
The customer-side difficulty
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
How the actual offer addresses it
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Intended benefits, never guarantees
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Supported features or delivery choices
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Only approved proof, near-verbatim
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Posicionamento
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
Category customers use to understand the offer
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Alternatives and the status quo
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
The main reason to choose it
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Narrow description of who it is for
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Only competitors named verbatim in the sources
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Oferta
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
object
Offering name
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
What is acquired
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
What the buyer receives
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Explicit price and unit; empty when unknown
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Scope explicitly included
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Delivery or commitment clause, with its qualifiers
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Work explicitly not done
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Buyer situations explicitly refused
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Prova
object
The current canvas, field by field; null when nothing was ever read or confirmed
object
object
Narrowest supported proof type
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Near-verbatim claim from the source
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Explicit customer, publication or certifier
object
Where this field currently stands: site, suggested, confirmed, admin or empty
Open disambiguation only
Always false until a person approves it
Version of the last confirmed canvas; null when it was never confirmed
ISO instant everything shown here was confirmed; null while it is a draft
Confirmed = every field is confirmed; draft = a new reading brought fields to confirm; empty = nothing yet
How many fields were written or approved by an admin
Example
{ "reading": { "status": "queued", "failureKind": "ai_unavailable" }, "canvases": { "company": { "canvas": { "name": { "origin": "site" }, "industry": { "origin": "site" }, "segment": { "origin": "site" }, "sizeSignal": { "value": "startup", "origin": "site" }, "description": { "origin": "site" }, "brandVoice": { "origin": "site" }, "website": { "origin": "site" }, "marketRegion": { "origin": "site" }, "resonantWords": { "origin": "site" }, "frictionWords": { "origin": "site" }, "pov": { "origin": "site" } }, "state": "confirmed" }, "icp": { "canvas": { "industries": { "origin": "site" }, "companySizeRange": { "origin": "site" }, "regions": { "origin": "site" }, "buyingTriggers": { "origin": "site" }, "exclusions": { "origin": "site" }, "qualificationSignals": { "origin": "site" }, "disqualificationSignals": { "origin": "site" } }, "state": "confirmed" }, "persona": { "canvas": { "personas": [ { "label": { "origin": "site" }, "titles": { "origin": "site" }, "responsibilities": { "origin": "site" }, "painPoints": { "origin": "site" }, "goals": { "origin": "site" }, "decisionCriteria": { "origin": "site" }, "objections": { "origin": "site" }, "buyingTriggers": { "origin": "site" }, "valueAngle": { "origin": "site" }, "channels": { "origin": "site" }, "beliefs": { "origin": "site" }, "fears": { "origin": "site" }, "asksVsWants": { "origin": "site" } } ] }, "state": "confirmed" }, "value-prop": { "canvas": { "headline": { "origin": "site" }, "problem": { "origin": "site" }, "solution": { "origin": "site" }, "outcomes": { "origin": "site" }, "differentiators": { "origin": "site" }, "proofPoints": { "origin": "site" } }, "state": "confirmed" }, "positioning": { "canvas": { "category": { "origin": "site" }, "frameOfReference": { "origin": "site" }, "keyDifferentiator": { "origin": "site" }, "targetMarket": { "origin": "site" }, "competitors": { "origin": "site" } }, "state": "confirmed" }, "offer": { "canvas": { "offerings": [ { "name": { "origin": "site" }, "whatItIs": { "origin": "site" }, "deliverables": { "origin": "site" }, "priceBand": { "origin": "site" }, "included": { "origin": "site" }, "timelineMechanism": { "origin": "site" } } ], "outOfScope": { "origin": "site" }, "noFit": { "origin": "site" } }, "state": "confirmed" }, "proof": { "canvas": { "items": [ { "type": { "value": "case", "origin": "site" }, "content": { "origin": "site" }, "attribution": { "origin": "site" } } ] }, "state": "confirmed" } }}Token ausente, inválido, expirado ou revogado
object
Stable machine-readable error code (e.g. identity.email_already_in_use)
Error class name
HTTP status code
Human-readable message, safe to display to end users
Correlation id — send it to support to locate the full trail
Structured details safe for the frontend (field errors, ids)
object
Example
{ "type": "public_api.invalid_credential", "title": "InvalidCredentialError", "status": 401, "detail": "Token de acesso inválido, expirado ou revogado. Crie um novo token de acesso no Nexo.", "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb"}Papel, escopo do token ou plano não permitem a operação
object
Stable machine-readable error code (e.g. identity.email_already_in_use)
Error class name
HTTP status code
Human-readable message, safe to display to end users
Correlation id — send it to support to locate the full trail
Structured details safe for the frontend (field errors, ids)
object
Example
{ "type": "public_api.insufficient_scope", "title": "InsufficientScopeError", "status": 403, "detail": "Este token não tem o escopo conversations:read, exigido por esta operação. Gere um token com esse escopo.", "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb", "meta": { "operation": "conversations.reading", "scope": "conversations:read" }}Limite de chamadas da empresa ou do token atingido
object
Stable machine-readable error code (e.g. identity.email_already_in_use)
Error class name
HTTP status code
Human-readable message, safe to display to end users
Correlation id — send it to support to locate the full trail
Structured details safe for the frontend (field errors, ids)
object
Example
{ "type": "public_api.rate_limited", "title": "PublicRateLimitedError", "status": 429, "detail": "Muitas chamadas em pouco tempo. Tente de novo em 12 segundos.", "requestId": "019fcae7-3e54-755a-8458-bdb605b324bb", "meta": { "class": "content", "limitedBy": "company", "limit": 120, "windowSeconds": 60, "retryAfterSeconds": 12 }}