GTM Motions
As motions de go-to-market da sua organização e o gtmMotionId de cada uma
O que é uma GTM motion
Uma GTM (go-to-market) motion é uma das formas como a sua organização vai ao mercado, como uma loja online e um time de vendas B2B. Na plataforma V4MOS.AI, cada motion agrupa as próprias conexões e campanhas. Uma das motions da organização é a padrão.
Primeiros passos
URL base: https://data.v4mos.ai. Toda chamada exige as suas credenciais de API e o organizationId — veja Autenticação. Este endpoint aceita o par de credenciais de cliente ou um token de usuário; um token de conta de serviço do cliente recebe 403.
- Chame
GET /v1/gtm-motions?organizationId=…e pegue oidda motion que você quer. - Envie esse valor como
gtmMotionIdaos endpoints de análise: Lucratividade, Produtos, Cupons, Forecast e E-commerce Summary.
| Campo | O que é |
|---|---|
id | O valor a enviar como gtmMotionId. |
name / slug | O nome dado na plataforma e a forma dele para URL. |
gtmType | lead_gen, ecommerce, marketplace ou loja_fisica. null quando não foi definido. |
businessModel | O modelo de negócio da motion. null quando não foi definido. |
isDefault | true na motion pela qual os endpoints respondem quando o gtmMotionId não é enviado. |
Como os endpoints de análise usam o gtmMotionId
O gtmMotionId é sempre opcional. Sem ele, a resposta cobre só a GTM motion padrão da organização, então integrações que nunca o enviam continuam funcionando como antes.
Por enquanto só a GTM motion padrão tem dados
Os endpoints de análise ainda não são recortados por GTM motion. A motion padrão (ou nenhum gtmMotionId) responde com os dados da organização, os mesmos números de antes; qualquer outra motion da organização recebe 422 com o código GTM_MOTION_DATA_NOT_AVAILABLE. Um gtmMotionId que não é UUID recebe 400, e um que não é motion da organização recebe 403 com o código GTM_MOTION_NOT_IN_ORGANIZATION, no mesmo formato de corpo do 422, para você distingui-lo de um 403 de falta de acesso.
Uma organização que ainda não configurou as suas GTM motions recebe uma lista vazia, e os endpoints de análise respondem pela organização inteira.