Como integrar o Mercado Livre com o n8n e o Whaticket

Neste tutorial, você conecta o Mercado Livre, o n8n e o Whaticket. O n8n consulta os pedidos pela API do Mercado Livre, um agente de IA (Google Gemini) resume as informações e o resultado chega como mensagem no Whaticket.

O que muda para sua operação

Você acompanha vendas e pedidos sem abrir o painel do Mercado Livre.
Os dados técnicos da API viram uma mensagem curta e fácil de ler.
O resumo fica registrado no chat do Whaticket para acompanhamento.

Antes de começar

Tenha uma conta no Mercado Livre e um aplicativo criado no portal Mercado Livre Developers, com o ID do aplicativo e a URI de redirecionamento definidos.
Tenha um token de acesso válido do Mercado Livre.
Tenha uma conta no n8n e uma credencial da API do Google Gemini.
No Whaticket, crie um token em Integrações > aba Tokens. Seu perfil precisa da permissão Criar do grupo Tokens de API, e o perfil escolhido para o token precisa das permissões Criar e Iniciar do grupo Campanhas.
Tenha o ID de uma conexão com o status Conectada. Para copiar, vá em Conexões, abra o menu de ações (três pontos) da conexão, clique em Editar e use o ícone de copiar ao lado do título da janela.

Passo a passo:

Crie o aplicativo no Mercado Livre

Acesse o portal Mercado Livre Developers e crie um novo aplicativo.
Configure o nome do aplicativo, a URI de redirecionamento, as permissões necessárias e os dados de segurança pedidos pelo Mercado Livre.

Siga a documentação oficial do Mercado Livre sobre criação de aplicativos para concluir essa configuração.

Obtenha o token de acesso

Para consultar pedidos pela API do Mercado Livre, você precisa de um token de acesso válido. Ele vai no cabeçalho de autorização do nó HTTP Request no n8n, no formato Authorization: Bearer SEU_TOKEN_DE_ACESSO.

Configure a consulta de pedidos no n8n

No n8n, adicione um nó HTTP Request.
Em Method, selecione GET.
Em URL, informe https://api.mercadolibre.com/orders/search?seller=SEU_SELLER_ID&item=SEU_ITEM_ID, com o ID do vendedor e o ID do produto.
Em Authentication, deixe None.
Ative Send Headers e adicione o cabeçalho Authorization com o valor Bearer SEU_TOKEN_DE_ACESSO.

Essa requisição busca os pedidos de um vendedor para um produto específico. Teste-a antes de seguir.

Resuma os dados com um agente de IA

Depois do nó de consulta, adicione um nó AI Agent.
Escreva a instrução do agente. Por exemplo: Você é um analista de dados. Revise os resultados recebidos do Mercado Livre e gere um resumo claro apenas quando houver vendas ou pedidos.

Configure o modelo de IA

No AI Agent, adicione o modelo Google Gemini Chat Model.
Em Credential, selecione sua conta da API do Google Gemini.
Em Model, escolha um modelo Gemini disponível na sua conta.

Envie o resultado para o Whaticket

Depois do AI Agent, adicione um segundo nó HTTP Request.
Em Method, selecione POST e, em URL, informe https://api.whaticket.com/api/v1/messages.
Ative Send Headers e adicione o cabeçalho Authorization com valor Bearer seguido da chave do token do Whaticket. É o único cabeçalho que a API do Whaticket exige.
Ative Send Body e, em Body Content Type, selecione JSON.

Monte o JSON de envio

No corpo da requisição, use uma estrutura como esta:

{
  "connectionId": "ID_DA_SUA_CONEXAO",
  "messages": [
    {
      "number": "5511999999999",
      "name": "Mercado Livre",
      "body": "Resumo dos pedidos do Mercado Livre"
    }
  ]
}

Troque ID_DA_SUA_CONEXAO pelo ID da conexão copiado no Whaticket.
Em number, informe o número que vai receber o resumo, só com dígitos e no formato internacional.
Em body, arraste a saída do AI Agent do painel da esquerda para usar o resumo gerado pela IA.
Clique em Execute step. Se aparecer messages scheduled, o envio foi agendado.

Confira o envio no Whaticket

Acesse o Whaticket e abra Chats.
Pesquise o contato informado no JSON.
Confira se a mensagem com o resumo chegou.

Perguntas frequentes

O envio consome créditos?
Só se a conexão for WhatsApp QR Code.

Posso enviar por uma conexão da API oficial do WhatsApp?
Sim, mas nas conexões WhatsApp API Cloud e WhatsApp API Coexistência o envio usa um modelo de mensagem aprovado, informado no campo templateId. Veja os detalhes em Integrações > Documentação.

Por que a mensagem não chegou?
Confira se o token de acesso do Mercado Livre está válido, se a URL usa o ID do vendedor e do produto corretos, se a chave do token do Whaticket está certa e se a conexão informada em connectionId está Conectada.

Como evito mensagens vazias?
Teste a consulta do Mercado Livre antes de conectar o agente de IA e oriente o agente a gerar o resumo só quando houver vendas ou pedidos.

Posso compartilhar o fluxo com outras pessoas?
Sim, mas nunca compartilhe tokens ou credenciais publicamente. Anote o ID do vendedor, o ID do produto e a conexão usados para facilitar a manutenção.