Quando você consulta os dados da sua conta edrone pelo MCP Connector, muitos campos trazem IDs numéricos em vez de nomes. Este artigo mostra o que cada ID significa, para que você (e o Claude) leiam os dados de atribuição do jeito certo.
O MCP Connector conecta a sua conta edrone a assistentes de IA como o Claude. Ele também pode aparecer com o nome AI Connector. Ainda não conectou? Siga o guia de configuração: MCP Connector: converse com seus dados da edrone no Claude e no ChatGPT.
📌 Dica: Use sempre os IDs deste artigo como referência, e não valores de exemplo que você encontrar em outros lugares.
Quais campos usam qual lista
Campo | O que o ID significa | Seção |
engagementTypeId, attributedByEngagementTypeId | Tipo de engajamento: o tipo de campanha ou automação | Tipos de engajamento |
channelTypeId, attributedByChannelTypeId, channelId | Canal | Canais |
attributionReasonId | Por que o pedido foi atribuído a uma mensagem | Motivos de atribuição |
isSocialProof, isSmartRecommendation, isRecommendationFrame, isAIAgent | Elementos onsite com os quais o cliente teve contato antes de comprar | Flags onsite nos pedidos |
Tipos de engajamento
Campos: engagementTypeId e attributedByEngagementTypeId. É um único dicionário, usado em todo lugar: nos fluxos, nos relatórios e nos pedidos. Alguns tipos mais antigos podem nunca aparecer na sua conta.
Campanhas
ID | Nome técnico | O que é |
6 | NEWSLETTER | Newsletter |
8 | SMS_NEWSLETTER | Campanha de SMS |
11 | CUSTOM_NEWSLETTER | Newsletter personalizada |
13 | NEWSLETTER_AB | Newsletter A/B |
14 | NEWSLETTER_CATEGORIES | Newsletter por categorias |
17 | PUSH_NEWSLETTER | Campanha push |
22 | NEWSLETTER_HUB | Campanha de newsletter por e-mail (Newsletter Hub) – o tipo mais comum hoje |
30 | WHATSAPP_NEWSLETTER | Campanha de WhatsApp |
37 | CUSTOMERS_ACTIVATION |
Fluxos Customizados
ID | Nome técnico | O que é |
21 | CUSTOM_FLOW | Fluxo Customizado (Custom Flow) – fluxos que você monta no construtor de fluxos |
Automações prontas (Fluxos Prontos)
Quando existe um artigo da Central de Ajuda sobre o fluxo, o nome leva até ele e segue o nome usado no artigo. Nomes sem link são apenas descrições.
ID | Nome técnico | Fluxo |
1 | RESTORE_CUSTOMERS | |
2 | LOYALTY_PROGRAM | |
3 | BIGGEST_SPENDERS | Clientes que mais gastam |
4 | FREQUENT_BUYERS | Clientes que compram com frequência |
5 | ABANDONED_CARTS | |
7 | ADVANCED_RESTORE_CUSTOMERS | |
9 | AFTER_SALE | |
10 | NEWSLETTER_SUBSCRIPTION | |
12 | WISH_LIST | Lista de desejos |
15 | RECOMMENDATIONS | |
16 | CROSS_SELLING_TRANSACTIONAL | |
18 | CHAT_SUBSCRIPTION | Inscrição pelo chat |
19 | BIRTHDAY | |
20 | REFER_A_FRIEND | Indique um amigo |
23 | NEWSLETTER_SIGN_UP_AFTER_PURCHASE | |
24 | PRICE_CHANGE_UP | |
25 | PRICE_CHANGE_DOWN | |
26 | LOW_STOCK_PRODUCTS | |
27 | NEWEST_PRODUCTS | |
28 | ASK_FOR_REVIEW | |
29 | BACK_IN_STOCK | |
31 | SMS_SUBSCRIPTION | |
32 | RECOVER_UNPAID_ORDER | Recuperação de pedidos não pagos |
33 | REVIEW_REQUEST | Solicitação de avaliação |
34 | CALL_ME_BACK | |
35 | PRIVACY_POLICY | Política de privacidade |
36 | WHATSAPP_SUBSCRIPTION | |
38 | CUSTOMER_REACTIVATION | Reativação de clientes |
39 | CASHBACK | |
40 | CYCLIC_LOYALTY_PROGRAM |
Onde cada tipo de engajamento aparece
list_engagements retorna as automações prontas, uma linha por tipo, mas não todas. Solicitação de avaliação (33) nunca aparece ali. Lista de desejos (12), Inscrição pelo chat (18) e Indique um amigo (20) só aparecem se a sua conta tiver acesso a eles. Os tipos mais antigos 3, 4 e 34 não aparecem. Fluxos Customizados (21) e todos os tipos de campanha nunca aparecem ali, mesmo quando há pedidos atribuídos a eles.
get_automation_reports considera os Fluxos Customizados e as automações prontas, sem newsletters. Lista de desejos (12), Inscrição pelo chat (18), Indique um amigo (20) e Política de privacidade (35) não estão incluídos.
As campanhas 6, 8, 11, 13, 14, 22, 30 e 37 aparecem em get_newsletter_reports, com o ID do canal. As campanhas push (17) não aparecem: use get_push_newsletter_report ou get_push_newsletter_statistics.
⚠️ Importante: Se um pedido está atribuído ao tipo 21, 22 ou 33 e esse tipo não aparece em list_engagements, não está faltando nada. Confira get_automation_reports (Fluxos Customizados e Solicitação de avaliação) ou get_newsletter_reports (campanhas).
Canais
Campos: channelTypeId, attributedByChannelTypeId e channelId.
ID | Canal |
1 | |
2 | SMS |
4 | Push |
8 | Chat |
16 | |
32 | Messenger |
64 | Allegro |
128 | AI Agent |
Não existe canal 3.
attributedByChannelTypeId é o canal da mensagem específica que recebeu a atribuição. Exemplo: um Fluxo Customizado (tipo 21) pode enviar WhatsApp, então tipo 21 com canal 16 é normal.
Motivos de atribuição
Campo: attributionReasonId. Mostra o que o cliente fez com a mensagem.
ID | Canal | Interação |
1 | Abertura | |
4 | Clique | |
8 | SMS | Entrega |
16 | SMS | Clique |
32 | Entrega | |
64 | Abertura (leitura) | |
128 | Clique |
Ou seja, um pedido pode ser atribuído a uma mensagem de WhatsApp ou SMS sem clique.
⚠️ Importante: O motivo 1 é de e-mail. Se você buscar atribuições de WhatsApp só com o motivo 1, não vai encontrar nada.
Em get_engagement_attributions, o campo attributionReasonId funciona como uma soma de IDs. Envie 0 para ver todos os motivos, ou some os IDs para combiná-los. Por exemplo, use 224 (32 + 64 + 128) para todos os motivos de WhatsApp ou 5 (1 + 4) para todos os motivos de e-mail.
clickRevenue e supportedRevenue
Os relatórios de automações e de newsletters dividem a receita atribuída em dois campos. A divisão não depende só do motivo de atribuição: o que conta é se um clique na mensagem foi registrado.
Campo | O que considera |
clickRevenue | Receita atribuída em que o cliente clicou na mensagem: motivos 4, 16 e 128, e também qualquer atribuição de e-mail, SMS ou WhatsApp em que um clique no link da mensagem foi registrado. |
supportedRevenue | Receita atribuída sem clique registrado: uma abertura, entrega ou leitura (motivos 1, 8, 32, 64). |
Os dois campos consideram só mensagens. Elementos onsite não entram (veja a próxima seção).
Flags onsite nos pedidos
Os pedidos podem ter quatro flags onsite:
Flag | Elemento onsite |
isSocialProof | Social proof |
isSmartRecommendation | Recomendações on-site (Smart Recommendations) |
isRecommendationFrame | Vitrine de recomendação |
isAIAgent | AI Agent |
Quando a flag é true, isso significa:
isSocialProof e isSmartRecommendation: o cliente viu ou clicou naquele elemento até 1 dia antes do pedido.
isRecommendationFrame: o cliente viu ou clicou em uma vitrine de recomendação até 30 dias antes do pedido.
Nessas três flags, só contam os eventos depois do pedido anterior do cliente.
isAIAgent: o AI Agent recomendou produtos ao cliente, ou o cliente clicou em um produto recomendado ou o adicionou ao carrinho.
Essas flags não são uma atribuição de mensagem. Elas não têm ID de tipo de engajamento e não mudam a mensagem à qual o pedido é atribuído.
Exemplo: um pedido com social proof e sem nenhuma interação com mensagens tem attributedByEngagementTypeId: null. Ele não entra nem em clickRevenue nem em supportedRevenue.
O valor null significa que as estatísticas onsite desse pedido não estão disponíveis, por exemplo em pedidos muito recentes que ainda não foram processados. Não significa false.
Ao lado dessas flags ficam os contadores por pedido emailsCount, smsCount e whatsappCount.
Dicas práticas
Receita por canal: Use get_revenue_by_channel. Ele retorna e-mail, SMS e WhatsApp, e cada canal considera todas as campanhas e automações enviadas por ele. Não inclui push.
Uma campanha específica: Quando você envia engagementTypeId, get_engagement_attributions mostra a campanha mais recente daquele tipo. Para escolher uma campanha específica, envie engagementId.
📌 Dica: Vai começar uma análise de atribuição com o Claude? Cole antes as tabelas deste artigo no chat, para o Claude ler os IDs do jeito certo.
Ficou com dúvidas?
Se precisar de mais ajuda, chama a gente no chat 💬 ou pelo e-mail hello@edrone.me.