> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tintim as an MCP

> Let your AI agents use Tintim in real time through the Nekt MCP Gateway.

Tintim is a conversational sales and marketing platform. With this MCP, your AI agent can manage leads, analyze campaign performance, adjust pipeline stages, and track conversions directly from your conversational data.

| | Available |
| :- | :- |
| **Nekt Express** | Yes |
| **GCP** | Yes |
| **AWS** | Yes |

## Adding Tintim as an MCP

Before you start, make sure the [MCP Server](/mcp-server/setup) is set up. See [MCPs](/mcps/overview) for how MCPs work.

1. Go to **Activate → [MCPs](https://app.nekt.ai/mcps)**, click **New MCP** and choose **Tintim**.
2. **Name your MCP** and describe what it is used for. The agent reads the description to choose between MCPs of the same provider.
3. **Setup access**. Click the sign-in button and authorize with an account that can see the data you want the agent to use. Actions run with that account's permissions.
   * **Sign in with Tintim** (Required): Sign in with a Tintim user that has access to the accounts you want to read from and manage. Actions respect that user's Tintim permissions.
4. **Select tools**. Pick the tools your agents can use. See [Available tools](#available-tools) below.
5. Click **Save**. On Growth and Custom plans, choose who can use it; see [Access levels](/mcps/overview#access-levels).

## Example prompts

* "What is our current conversion rate and total revenue for the last 30 days?"
* "Can you list the active leads from Meta Ads that are currently waiting for a first response?"
* "Create a new lead for the phone number 5511999998888 and assign it to the Google source."
* "Move the lead with ID 1042 to the completed sale pipeline stage and record a sale amount of 250."

## Available tools

Choose which of these tools your agents can use in **Select tools**.

### Read tools

| Tool | Description | Parameters |
| :- | :- | :- |
| `accounts_get` | Retorna os detalhes e as configurações de uma conta específica. | `account_code` (string, required) |
| `accounts_list` | Lista as contas Tintim que você pode acessar, com o tipo de acesso, se a API v2 está habilitada em cada uma e se você consegue ler as mensagens das conversas dela. Diga ao usuário quais das contas listadas estão fora do seu alcance e por quê: `api_enabled` falso quer dizer que a… | `page` (integer), `search` (string), `status` (string), `page_size` (integer), `workspace` (string) |
| `campaigns_get` | Retorna os detalhes de um link rastreável específico, com as URLs prontas para divulgar. | `campaign_id` (integer, required), `account_code` (string, required) |
| `campaigns_list` | Lista os links rastreáveis (campanhas) ativos de uma conta, com as URLs prontas para divulgar de cada um; search procura pelo nome. | `account_code` (string, required), `page` (integer), `search` (string), `page_size` (integer) |
| `campaigns_stats` | Retorna o funil de conversão de um link rastreável; operação custosa que agrega todos os leads e vendas de todas as visitas do link. | `campaign_id` (integer, required), `account_code` (string, required) |
| `connection_status` | Retorna o status da conexão de WhatsApp de uma conta. | `account_code` (string, required) |
| `conversions_list` | Lista os eventos de conversão configurados em uma conta; search procura pelo nome do evento. Um evento registrado antes de as plataformas existirem traz platform 0 e platform\_display nulo. | `account_code` (string, required), `page` (integer), `search` (string), `page_size` (integer) |
| `copilot_usage_get` | Retorna quantas conversas a IA já analisou na conta no mês corrente e o limite mensal de análises. | `account_code` (string, required) |
| `creatives_list` | Lista o desempenho dos criativos de anúncios de uma conta, por campanha, conjunto ou anúncio. | `account_code` (string, required), `ad` (string), `page` (integer), `adset` (string), `level` (string), `campaign` (string), `date_end` (string), `order_by` (string), `page_size` (integer), `ad_account` (string), `date_start` (string) |
| `events_counts` | Conta as conversões que uma conta enviou às plataformas de anúncios, sem paginar, separadas pela plataforma de destino e pela situação do envio: confirmadas, agendadas, na fila e recusadas. Aceita os mesmos filtros de `events_list`, então os números correspondem exatamente ao qu… | `account_code` (string, required), `lead_id` (integer), `platform` (integer) |
| `events_get` | Retorna um disparo do histórico de conversões de uma conta com o payload enviado à plataforma de anúncios, que explica a causa de uma falha. | `event_id` (integer, required), `account_code` (string, required) |
| `events_list` | Lista o histórico de eventos de conversão enviados às plataformas de anúncios por uma conta. | `account_code` (string, required), `page` (integer), `lead_id` (integer), `platform` (integer), `page_size` (integer) |
| `facebook_ad_accounts_list` | Lista as contas de anúncio alcançadas pela conexão de quem chama com o Meta Ads, marcando quais alimentam a conta; conversa com a Meta a cada chamada. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `facebook_ad_messages_list` | Lista as mensagens vinculadas a anúncios do Meta Ads em uma conta, com busca por nome e recorte pelo `ad_id` exato do anúncio. | `account_code` (string, required), `page` (integer), `ad_id` (integer), `search` (string), `page_size` (integer), `message_status` (string) |
| `facebook_ads_list` | Lista os anúncios do Meta Ads disponíveis para vincular mensagens em uma conta. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `google_ad_messages_get` | Retorna os detalhes de uma mensagem vinculada a anúncio do Google Ads. | `account_code` (string, required), `google_ad_message_id` (integer, required) |
| `google_ad_messages_list` | Lista as mensagens vinculadas a anúncios do Google Ads em uma conta, com busca por nome da campanha, do grupo de anúncios ou do anúncio e recorte pelo `ad_id` exato do anúncio. | `account_code` (string, required), `page` (integer), `ad_id` (string), `search` (string), `page_size` (integer) |
| `google_ads_connection_accessible_customers` | Lista as contas do Google Ads que uma conexão alcança e, em `access_paths`, por quais caminhos a autorização chega até cada uma — acesso direto ou por uma conta de gerência (MCC). É o conjunto de escolhas para definir qual conta recebe as conversões: a escolha pede o `id` da con… | `account_code` (string, required), `connection_id` (integer, required) |
| `google_ads_connection_status` | Retorna a situação da conexão de uma conta com o Google Ads e a conta do Google Ads escolhida para receber as conversões. | `account_code` (string, required) |
| `google_ads_connections_list` | Lista as conexões de uma conta com o Google Ads, incluindo as revogadas, com a conta do Google Ads escolhida em cada uma e o caminho de acesso por onde o Tintim fala com ela. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `google_ads_conversion_actions_list` | Lista as ações de conversão da conta do Google Ads conectada, de onde sai o id que um evento de conversão do Google Ads exige. | `account_code` (string, required) |
| `google_ads_get` | Retorna os detalhes de um anúncio do Google Ads específico. | `account_code` (string, required), `google_ad_id` (integer, required) |
| `google_ads_list` | Lista os anúncios do Google Ads cadastrados em uma conta. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `identified_conversions_counts` | Conta as conversões identificadas pela IA em uma conta, sem paginar: quantas aguardam revisão agora e quantas conversas a revisão humana já confirmou como venda. Nenhum dos dois números é recortado por período, e ambos aceitam os mesmos filtros de `identified_conversions_list`.… | `account_code` (string, required), `source` (array), `confidence` (string) |
| `identified_conversions_get` | Retorna uma conversão identificada com as mensagens que a IA guardou como evidência, inclusive as revisões já aprovadas ou recusadas. Como a evidência é a conversa em si, a leitura exige a visualização de mensagens habilitada na conta, que sem isso responde `feature_not_enabled`… | `account_code` (string, required), `identified_conversion_id` (integer, required) |
| `identified_conversions_list` | Lista as conversões identificadas pela IA que aguardam revisão em uma conta. | `account_code` (string, required), `page` (integer), `source` (array), `page_size` (integer), `confidence` (string) |
| `integration_platforms_list` | Lista em `results` as plataformas de automação que o Tintim integra e o que cada uma exige: tipos de conexão, formas de acesso com os campos de cada uma, campos obrigatórios, opções de provedor e orientações. Leia esta ferramenta primeiro e componha a partir dela os argumentos d… | `account_code` (string, required), `page` (integer), `search` (string), `page_size` (integer) |
| `leads_batch_status_preview` | Resolve uma lista de telefones nos leads de uma conta, sem escrever nada, para conferir quem será movido antes de mover. Devolve os leads encontrados com o `id` e a etapa atual de cada um, e os telefones sem conversa ativa na conta. Compartilha o limite de \`leads\_batch\_status\_ch… | `phones` (array, required), `account_code` (string, required) |
| `leads_counts` | Conta as conversas de um recorte inteiro de uma conta, sem paginar: o total, o recorte por origem, o recorte por forma de contato e uma linha por etapa ativa da jornada. Aceita os mesmos filtros da listagem, então os números correspondem exatamente ao que `leads_list` pagina. | `account_code` (string, required), `search` (string), `source` (array), `status` (array), `ad_adset` (array), `campaign` (array), `creative` (array), `utm_medium` (string), `utm_source` (string), `ad_campaign` (array), `utm_campaign` (string), `contact_method` (array), `last_message_end` (string), `first_message_end` (string), `last_message_label` (string), `last_message_start` (string), `first_message_label` (string), `first_message_start` (string), `last_status_change_end` (string), `awaiting_first_response` (boolean), `last_status_change_label` (string), `last_status_change_start` (string) |
| `leads_get` | Retorna os detalhes de um lead específico. A leitura de uma conversa traz seis campos que a listagem não traz: o `email`, o dispositivo do clique que a originou em `visit`, o `journey_time` até a primeira venda, o `first_response_time` da equipe, a `initial_message` que já chego… | `lead_id` (integer, required), `account_code` (string, required) |
| `leads_list` | Lista os leads de uma conta, com suporte a filtros e ordenação. Para varrer a conta inteira sem pular nem repetir leads, use `id_after`: comece em 0 e repita passando o maior `id` da página anterior, e a cópia traz também as conversas removidas, marcadas com `is_active: false`.… | `account_code` (string, required), `page` (integer), `cursor` (string), `search` (string), `source` (array), `status` (array), `ad_adset` (array), `campaign` (array), `creative` (array), `id_after` (integer), `ordering` (string), `page_size` (integer), `utm_medium` (string), `utm_source` (string), `ad_campaign` (array), `utm_campaign` (string), `updated_after` (string), `contact_method` (array), `last_message_end` (string), `first_message_end` (string), `last_message_label` (string), `last_message_start` (string), `first_message_label` (string), `first_message_start` (string), `last_status_change_end` (string), `awaiting_first_response` (boolean), `last_status_change_label` (string), `last_status_change_start` (string) |
| `leads_messages` | Lista as mensagens de WhatsApp trocadas com um lead. | `lead_id` (integer, required), `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `leads_origin_history` | Lista a origem de um lead ao longo do tempo, da mais recente para a mais antiga. Cada linha é a atribuição que passou a valer naquele instante, com os mesmos campos da leitura do lead. | `lead_id` (integer, required), `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `leads_origin_updates` | Lista os registros de origem de todos os leads de uma conta, da alteração mais antiga para a mais nova. É a varredura da atribuição da conta inteira: use `updated_after` para receber apenas o que mudou desde a última sincronização. | `account_code` (string, required), `page` (integer), `cursor` (string), `page_size` (integer), `updated_after` (string) |
| `leads_recent_updates` | Lista as mudanças de etapa mais recentes entre todos os leads de uma conta. Com `updated_after` ela vira sincronização: as linhas vêm da alteração mais antiga para a mais nova e sempre com os registros removidos. | `account_code` (string, required), `page` (integer), `cursor` (string), `page_size` (integer), `updated_after` (string), `include_deleted` (boolean) |
| `leads_status_history` | Lista o histórico de mudanças de etapa de um lead. | `lead_id` (integer, required), `account_code` (string, required), `page` (integer), `page_size` (integer), `include_deleted` (boolean) |
| `me_get` | Retorna a identidade do usuário autenticado, os grupos aos quais ele pertence, se ele tem o Meta Ads conectado e a cota de contas ativas do workspace dele. | — |
| `metrics_active_leads` | Retorna a métrica de leads ativos do painel: o total de conversas cuja primeira mensagem caiu no período, a divisão entre rastreados e não rastreados — em número e em porcentagem — e o tempo médio de primeira resposta já escrito em português, como `7 minutos`, com \`has\_average\_f… | `account_code` (string, required), `source` (string), `date_end` (string), `date_start` (string), `contact_method` (string) |
| `metrics_contact_methods` | Retorna a distribuição dos leads ativos do período pela forma como a conversa começou: `whatsapp` para quem chamou direto no WhatsApp e `form` para quem veio de um formulário. `unknown` existe no formato, mas hoje responde sempre `0` — não tente derivar nada dele. \`total\_active\_… | `account_code` (string, required), `source` (string), `date_end` (string), `date_start` (string), `contact_method` (string) |
| `metrics_funnel` | Retorna o funil da jornada de compra dos leads ativos do período, uma etapa por linha, na ordem em que a conta ordenou a jornada. `value` conta os leads que estão naquela etapa ou em uma etapa posterior, e `percentage` é a conversão em relação à linha anterior — a primeira linha… | `account_code` (string, required), `source` (string), `date_end` (string), `date_start` (string), `contact_method` (string) |
| `metrics_origin` | Retorna a distribuição dos leads ativos do período entre as quatro origens que o Tintim reconhece: `meta`, `google`, `unknown` — o lead rastreado sem plataforma identificada — e `untracked`, o lead que chegou sem rastreio. `total_active_leads` é o total do período e fecha com a… | `account_code` (string, required), `source` (string), `date_end` (string), `date_start` (string), `contact_method` (string) |
| `metrics_sales` | Retorna a métrica de vendas do painel — quantas vendas o período teve, a taxa de conversão e a receita. `basis` diz sobre qual data as vendas foram apuradas e vem sempre na resposta: `saleDatetime` lê as vendas do histórico de etapas e conta cada uma no dia em que a etapa de ven… | `account_code` (string, required), `basis` (string), `source` (string), `date_end` (string), `date_start` (string), `contact_method` (string) |
| `metrics_top_counters` | Retorna os dois contadores do topo do painel: quantas conversas ativas ainda aguardam a primeira resposta e o tempo médio de jornada entre o primeiro contato e a primeira conversão, já escrito em português, como `1 dia`, com `has_average_journey_time` dizendo se houve o que medi… | `account_code` (string, required) |
| `onboarding_checklist` | Retorna as configurações iniciais de uma conta e em que pé está cada passo: conectar o WhatsApp, configurar a frase gatilho, identificar a primeira venda e configurar o rastreio das campanhas. A leitura não avança nada e o passo de rastreio considera a conexão com o Meta Ads de… | `account_code` (string, required) |
| `operators_list` | Lista os operadores associados a uma conta. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `pipeline_stages_list` | Lista as etapas da jornada (pipeline) de uma conta em ordem de funil. Basta alcançar a conta: é por aqui que se descobre o `id` da etapa para onde mover um lead. A leitura vai além do que a tela de conversas oferece ao operador: junto de cada etapa vem a sua configuração — \`defa… | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `reports_get` | Retorna o status e o link de download de um relatório específico. | `report_id` (integer, required), `account_code` (string, required) |
| `reports_list` | Lista os relatórios solicitados para uma conta. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `saved_filters_list` | Lista os filtros de leads salvos em uma conta. O recorte de cada filtro vem no mesmo vocabulário de `leads_list`, então ele pode ser passado direto como argumentos da listagem. | `account_code` (string, required), `page` (integer), `page_size` (integer) |
| `webhook_requests_counts` | Conta as entregas de webhook de uma conta, sem paginar, separadas por situação: aguardando, em nova tentativa, confirmadas e encerradas com erro. Aceita o mesmo `lead_id` de `webhook_requests_list`, então os números correspondem exatamente ao que a listagem pagina. Prefira esta… | `account_code` (string, required), `lead_id` (integer) |
| `webhook_requests_get` | Retorna os detalhes de uma entrega de webhook específica. | `request_id` (integer, required), `account_code` (string, required) |
| `webhook_requests_list` | Lista as entregas de webhook registradas em uma conta, opcionalmente filtradas por lead. O histórico da conta inteira exige acesso de gerenciamento; com o filtro `lead_id` basta ter acesso à conta. | `account_code` (string, required), `page` (integer), `lead_id` (integer), `page_size` (integer) |
| `webhooks_list` | Lista as configurações de webhook de uma conta. | `account_code` (string, required), `page` (integer), `page_size` (integer) |

### Write tools

| Tool | Description | Parameters |
| :- | :- | :- |
| `accounts_accept_messaging_terms` | Registra o aceite dos termos de uso das mensagens para esta credencial na conta e libera a leitura das conversas, que sem o aceite responde `messaging_terms_not_accepted`. Repetir a chamada é seguro: o momento do primeiro aceite é preservado. Peça a confirmação do usuário antes… | `account_code` (string, required) |
| `accounts_activate` | Ativa uma conta em período de teste, consumindo um slot de conta disponível. | `account_code` (string, required) |
| `accounts_dashboard_preferences_update` | Ajusta as preferências do painel da conta: se o tempo de primeira resposta é medido a partir da segunda mensagem e qual é a base de contagem padrão dos números de vendas e de funil. Uma conta que não apura as vendas pela data da venda recusa `saleDatetime`. Responde com as duas… | `account_code` (string, required), `dashboard_sales_and_funnel_basis` (string), `calculate_first_response_from_second_message` (boolean) |
| `accounts_deactivate` | Desativa uma conta ativa, interrompendo seu faturamento. Confirme com o usuário antes de desativar a conta. | `account_code` (string, required) |
| `accounts_update` | Atualiza os dados de uma conta, como nome, telefone da loja, área de atuação e as credenciais do pixel do Meta Ads. | `account_code` (string, required), `name` (string), `market_area` (string), `wpp_store_phone` (string), `facebook_pixel_id` (string), `wpp_first_message` (string), `facebook_access_token` (string), `send_untracked_leads_pixel_to_facebook` (boolean) |
| `campaigns_create` | Cria um novo link rastreável (campanha) para direcionar leads ao WhatsApp; a resposta já traz as URLs prontas para divulgar. | `name` (string, required), `account_code` (string, required), `wpp_first_message` (string, required), `message_for_redirect_title` (string), `message_for_redirect_content` (string), `whatsapp_desktop_link_redirect` (string) |
| `campaigns_delete` | Desativa um link rastreável, removendo-o da lista de campanhas ativas. Confirme com o usuário antes de desativar o link. | `campaign_id` (integer, required), `account_code` (string, required) |
| `campaigns_duplicate` | Duplica um link rastreável existente, gerando uma nova cópia. | `campaign_id` (integer, required), `account_code` (string, required) |
| `campaigns_update` | Atualiza a configuração de um link rastreável existente. | `campaign_id` (integer, required), `account_code` (string, required), `name` (string), `wpp_first_message` (string), `message_for_redirect_title` (string), `message_for_redirect_content` (string), `whatsapp_desktop_link_redirect` (string) |
| `connection_disconnect` | Inicia de forma assíncrona a desconexão da sessão de WhatsApp de uma conta. Confirme com o usuário antes de desconectar o WhatsApp. | `account_code` (string, required) |
| `conversions_create` | Cria um novo evento de conversão para envio às plataformas de anúncios. O Google Ads (platform 2) está sempre disponível: numa conta sem uma conta do Google Ads conectada o evento nasce só com nome, plataforma e descrição, para nomear as linhas do relatório de conversões offline… | `name` (string, required), `account_code` (string, required), `platform` (integer), `description` (string), `google_conversion_action_id` (string) |
| `conversions_delete` | Remove um evento de conversão de uma conta; o histórico de conversões já enviadas por ele é preservado. Confirme com o usuário antes de remover o evento. | `account_code` (string, required), `conversion_id` (integer, required) |
| `conversions_update` | Atualiza um evento de conversão existente. Numa conta sem uma conta do Google Ads conectada, trocar a plataforma é livre nos dois sentidos e a ação de conversão guardada sobrevive a toda edição, mas mandar um google\_conversion\_action\_id diferente do guardado é recusado. Com uma… | `account_code` (string, required), `conversion_id` (integer, required), `name` (string), `platform` (integer), `description` (string), `google_conversion_action_id` (string) |
| `facebook_ad_accounts_select` | Substitui a seleção de contas de anúncio do Meta Ads que alimentam a conta pela lista informada. A rota REST devolve as contas de anúncio da conexão como um array puro; aqui elas vêm embrulhadas em um objeto, sob a chave `accounts`. Confirme com o usuário a lista de contas de an… | `account_code` (string, required), `ad_account_ids` (array, required) |
| `facebook_ad_messages_create` | Cria mensagens de WhatsApp vinculadas a um ou mais anúncios do Meta Ads. A rota REST devolve as mensagens criadas como um array puro; aqui elas vêm embrulhadas em um objeto, sob a chave `messages`. | `ad_ids` (array, required), `message` (string, required), `account_code` (string, required) |
| `facebook_ad_messages_deactivate` | Desativa em lote mensagens vinculadas a anúncios do Meta Ads. Confirme com o usuário as mensagens selecionadas antes de desativar. | `ids` (array, required), `account_code` (string, required) |
| `facebook_ad_messages_publish` | Marca uma mensagem de anúncio do Meta Ads como publicada; é um caminho de mão única e não conversa com a Meta. | `account_code` (string, required), `ad_message_id` (integer, required) |
| `facebook_campaigns_refresh` | Sincroniza os anúncios do Meta Ads via Graph API; operação custosa e sujeita a limites de requisição da Meta. | `account_code` (string, required) |
| `feature_feedback_report` | Envia ao time do Tintim a opinião de quem usa uma funcionalidade do produto. | `account_code` (string, required), `feature_name` (string, required), `was_it_useful` (boolean, required), `details` (string), `problems` (string) |
| `google_ad_messages_create` | Cria mensagens de WhatsApp vinculadas a um ou mais anúncios do Google Ads. A rota REST devolve as mensagens criadas como um array puro; aqui elas vêm embrulhadas em um objeto, sob a chave `messages`. | `ad_ids` (array, required), `message` (string, required), `account_code` (string, required) |
| `google_ad_messages_delete` | Remove uma mensagem vinculada a anúncio do Google Ads. Confirme com o usuário antes de remover a mensagem. | `account_code` (string, required), `google_ad_message_id` (integer, required) |
| `google_ad_messages_update` | Atualiza o texto de uma mensagem vinculada a anúncio do Google Ads. | `message` (string, required), `account_code` (string, required), `google_ad_message_id` (integer, required) |
| `google_ads_connection_authorize` | Começa uma conexão de uma conta com o Google Ads e devolve o endereço do consentimento do Google. Quem abrir o endereço precisa estar autenticado no Tintim com o mesmo usuário dono desta credencial; ele serve uma vez só e vale 10 minutos. A conexão nova aparece em \`google\_ads\_co… | `account_code` (string, required) |
| `google_ads_connection_disconnect` | Desfaz uma conexão de uma conta com o Google Ads, revogando o acesso concedido ao Tintim. Confirme com o usuário antes de desfazer a conexão. | `account_code` (string, required), `connection_id` (integer, required) |
| `google_ads_connection_select_customer` | Escolhe a conta do Google Ads que uma conexão usa para receber as conversões e o caminho de acesso por onde o Tintim fala com ela: o `customer_id` da conta e o `login_customer_id` de um dos `access_paths` que `google_ads_connection_accessible_customers` traz para ela, os dois ob… | `customer_id` (string, required), `account_code` (string, required), `connection_id` (integer, required), `login_customer_id` (string, required) |
| `google_ads_create` | Cadastra um novo anúncio do Google Ads em uma conta. | `gid` (string, required), `name` (string, required), `account_code` (string, required), `ad_group_gid` (string, required), `ad_group_name` (string, required), `ad_campaign_gid` (string, required), `ad_campaign_name` (string, required) |
| `google_ads_delete` | Remove um anúncio do Google Ads de uma conta. Confirme com o usuário antes de remover o anúncio. | `account_code` (string, required), `google_ad_id` (integer, required) |
| `google_ads_update` | Atualiza um anúncio do Google Ads cadastrado. | `account_code` (string, required), `google_ad_id` (integer, required), `gid` (string), `name` (string), `ad_group_gid` (string), `ad_group_name` (string), `ad_campaign_gid` (string), `ad_campaign_name` (string) |
| `identified_conversions_approve` | Aprova conversões identificadas, movendo os leads para a etapa informada. Aprovar gasta o orçamento das mudanças de etapa, um lead por revisão informada: 120 leads a cada 60 segundos por usuário, dividido com `leads_status_change`, `leads_batch_status_change` e as rotas de mudan… | `review_ids` (array, required), `account_code` (string, required), `lead_status_id` (integer, required), `sale_amount` (string), `sale_datetime` (string) |
| `identified_conversions_reject` | Rejeita conversões identificadas que aguardavam revisão. | `review_ids` (array, required), `account_code` (string, required) |
| `integration_requests_create` | Envia uma solicitação de integração com uma plataforma de automação, como o formulário do produto a envia. Nenhuma credencial passa por esta chamada: não há argumento de usuário, telefone de acesso, senha ou token, e o único dado de acesso aceito é o `login_url`, que o produto g… | `account_code` (string, required), `provider` (string), `login_url` (string), `access_method` (string), `platform_name` (string), `connection_type` (string), `official_api_phone` (string), `platform_not_found` (boolean), `unknown_platform_name` (string) |
| `leads_batch_status_change` | Altera em lote a etapa da jornada de vários leads de uma só vez. O lote é tudo ou nada: ou todos os leads alcançados mudam de etapa, ou nenhum muda e nada é disparado. As mudanças de etapa gastam um orçamento próprio de 120 leads a cada 60 segundos por usuário, dividido por toda… | `status` (integer, required), `lead_ids` (array, required), `account_code` (string, required), `sale_amount` (string), `sale_datetime` (string) |
| `leads_create` | Cria um lead na conta a partir do telefone, com nome, e-mail, origem e parâmetros UTM opcionais. A conversão de primeiro contato só é enviada ao Google Ads quando é a primeira mensagem do lead que cria a conversa; um lead criado por aqui já existe quando essa mensagem chega, ent… | `phone` (string, required), `account_code` (string, required), `name` (string), `email` (string), `source` (string), `utm_term` (string), `utm_medium` (string), `utm_source` (string), `utm_content` (string), `utm_campaign` (string) |
| `leads_recalculate_first_response` | Refaz, a partir das mensagens da conversa, o tempo que a equipe levou para responder o primeiro contato do lead, e grava o resultado. Use quando a conversa volta com `first_response_status` nulo, o que acontece nas conversas anteriores a esse cálculo. Devolve a conversa já class… | `lead_id` (integer, required), `account_code` (string, required) |
| `leads_status_change` | Altera a etapa da jornada de um lead, registrando a venda quando aplicável. `event_id` é a chave de idempotência e identifica a chamada, não o registro que ela cria: uma vez usado para um lead ele segue reservado mesmo que o registro seja removido do histórico, e repeti-lo respo… | `status` (integer, required), `lead_id` (integer, required), `account_code` (string, required), `customer` (any), `event_id` (string), `sale_amount` (string), `sale_datetime` (string) |
| `leads_status_history_delete` | Remove um registro do histórico de etapas de um lead e reordena o histórico. O `event_id` do registro removido segue reservado para aquele lead — a mudança corrigida vai com um `event_id` novo. Mesmo quando o lead volta para a etapa anterior, o `last_status_change_datetime` dele… | `lead_id` (integer, required), `history_id` (integer, required), `account_code` (string, required) |
| `leads_status_history_update` | Corrige o valor da venda gravado em uma linha do histórico de etapas de um lead. A linha passa a contar como alteração manual, e quando ela é a venda mais recente do lead o valor da conversa acompanha. Nenhuma conversão ou webhook é redisparado. | `lead_id` (integer, required), `history_id` (integer, required), `sale_amount` (string, required), `account_code` (string, required) |
| `leads_update` | Atualiza o nome ou a origem de um lead. | `lead_id` (integer, required), `account_code` (string, required), `name` (string), `source` (string) |
| `me_accept_product_terms` | Registra o aceite dos termos de uso do Tintim para o usuário autenticado e libera as demais ferramentas, que sem o aceite respondem `product_terms_not_accepted`. Repetir a chamada é seguro: o momento do aceite mais recente é preservado. Peça a confirmação do usuário antes de cha… | — |
| `me_password_reset` | Manda ao e-mail cadastrado do usuário autenticado o link que abre a página de escolha de senha. A senha nunca passa por aqui: a resposta traz só o endereço para onde o e-mail saiu, e a troca termina no navegador. O link vale por 3 dias. | — |
| `me_update` | Atualiza o nome, o sobrenome e o telefone do usuário autenticado. | `phone` (string), `last_name` (string), `first_name` (string) |
| `missing_feature_report` | Guarda para o time do Tintim um pedido que o produto não atende. Chame esta ferramenta apenas quando nenhuma das outras atender ao pedido do usuário, dizendo em uma frase o que ele quis fazer e em outra o que faltou. Não inclua nomes, telefones nem o conteúdo de mensagens de lea… | `missing` (string, required), `request` (string, required), `account_code` (string) |
| `onboarding_choose_tracking_method` | Registra para onde as campanhas da conta levam as pessoas: `wpp` direto para o WhatsApp, `website` para um site ou landing page. Vale a primeira escolha — uma segunda chamada devolve o método que já estava valendo sem trocá-lo. | `account_code` (string, required), `tracking_method` (string, required) |
| `onboarding_confirm_campaign_info` | Confirma que os botões do site já apontam para o link rastreável do Tintim. Fecha o passo do rastreio e conclui as configurações iniciais da conta quando os demais passos já estão prontos. | `account_code` (string, required) |
| `onboarding_confirm_pixel_installed` | Confirma que o pixel do Tintim já está instalado no site da conta. Sozinha, a confirmação não fecha o passo do rastreio nem conclui as configurações iniciais. | `account_code` (string, required) |
| `operators_create` | Associa um operador a uma conta pelo e-mail, criando o convite quando necessário. O convite tem um orçamento próprio, contado pela conta que convida e não por quem chama: 30 convites a cada 3600 segundos por conta, dividido com a rota `POST /accounts/{account_code}/operators`, c… | `email` (string, required), `account_code` (string, required) |
| `operators_password_reset` | Manda ao operador o e-mail com o link que abre a página de escolha de senha: o convite da conta outra vez para quem ainda não definiu uma senha, um pedido neutro de redefinição para quem já entrou. A senha nunca passa por aqui — a resposta traz só o endereço para onde o e-mail s… | `user_id` (integer, required), `account_code` (string, required) |
| `operators_remove` | Remove um operador de uma conta. Confirme com o usuário antes de remover o operador. | `user_id` (integer, required), `account_code` (string, required) |
| `operators_update` | Atualiza o nome, o sobrenome e o telefone de um operador da conta. | `user_id` (integer, required), `account_code` (string, required), `phone` (string), `last_name` (string), `first_name` (string) |
| `pipeline_stages_create` | Cria uma nova etapa da jornada em uma conta. | `name` (string, required), `account_code` (string, required), `is_sales` (boolean), `hook_message` (string), `default_value` (string), `conversion_ids` (array), `is_first_contact` (boolean) |
| `pipeline_stages_delete` | Desativa uma etapa da jornada de uma conta. Confirme com o usuário antes de desativar a etapa. | `stage_id` (integer, required), `account_code` (string, required) |
| `pipeline_stages_reorder` | Reordena as etapas da jornada conforme a lista de identificadores informada. A rota REST devolve a jornada reordenada como um array puro; aqui ela vem embrulhada em um objeto, sob a chave `stages`. | `order` (array, required), `account_code` (string, required) |
| `pipeline_stages_update` | Atualiza uma etapa da jornada existente. O que você não mandar fica como está, e mandar null é recusado, exceto em hook\_message e default\_value, onde ele esvazia o campo. conversion\_ids substitui a lista inteira, e \[] desassocia todos os eventos de conversão da etapa. | `stage_id` (integer, required), `account_code` (string, required), `name` (string), `is_sales` (boolean), `hook_message` (string), `default_value` (string), `conversion_ids` (array), `is_first_contact` (boolean) |
| `reports_create` | Solicita a geração assíncrona de um relatório em CSV para uma conta: conversas, conversões offline com GCLID, mudanças de etapa da jornada ou histórico de vendas. | `account_code` (string, required), `filters` (object), `report_type` (string) |
| `saved_filters_create` | Cria um novo filtro de leads salvo em uma conta. | `name` (string, required), `account_code` (string, required), `filters` (object) |
| `saved_filters_delete` | Remove um filtro de leads salvo de uma conta. Confirme com o usuário antes de remover o filtro. | `filter_id` (integer, required), `account_code` (string, required) |
| `saved_filters_update` | Atualiza um filtro de leads salvo existente. | `filter_id` (integer, required), `account_code` (string, required), `name` (string), `filters` (object) |
| `webhook_requests_resend` | Reenvia de forma assíncrona uma entrega de webhook. | `request_id` (integer, required), `account_code` (string, required) |
| `webhooks_create` | Cria uma nova configuração de webhook para uma conta. | `name` (string, required), `account_code` (string, required), `trigger_meta` (boolean), `trigger_google` (boolean), `lead_create_url` (string), `lead_update_url` (string), `trigger_untracked` (boolean), `message_create_url` (string), `trigger_tracked_link` (boolean), `lead_source_update_url` (string) |
| `webhooks_delete` | Remove uma configuração de webhook de uma conta. Confirme com o usuário antes de remover a configuração. | `webhook_id` (integer, required), `account_code` (string, required) |
| `webhooks_toggle` | Inverte o estado de uma configuração de webhook: desativar interrompe a entrega dos eventos dela. Confirme com o usuário antes de inverter o estado. | `webhook_id` (integer, required), `account_code` (string, required) |
| `webhooks_update` | Atualiza uma configuração de webhook existente. | `webhook_id` (integer, required), `account_code` (string, required), `name` (string), `trigger_meta` (boolean), `trigger_google` (boolean), `lead_create_url` (string), `lead_update_url` (string), `trigger_untracked` (boolean), `message_create_url` (string), `trigger_tracked_link` (boolean), `lead_source_update_url` (string) |

## Troubleshooting

If your access expires or is revoked by Tintim, the MCP will show that it needs to reconnect. You can resolve this by navigating to the MCP's page in Nekt and signing in again to authorize the connection.

## Need help?

Contact our support team if you have trouble connecting Tintim.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.