A API INK e o webhook abrem os dados da sua loja para outras ferramentas. Este artigo mostra cinco usos concretos, com o que você precisa, como montar e o que observar em cada um.
Duas coisas antes de começar, para não haver surpresa.
Nenhuma ferramenta tem conexão pronta com a INK. Não existe um botão de conectar. Alguém precisa montar a ligação, usando a API INK e o webhook de um lado e a API da outra ferramenta do outro. Pode ser o seu integrador, alguém do seu time que mexe com isso, ou uma ferramenta de automação, que serve de ponte e reduz bastante o trabalho.
A API INK e o webhook estão disponíveis apenas no plano Inkrível. A ferramenta do outro lado também pode cobrar por isso: no Sistema ERP da Olist, o antigo Tiny, as integrações via API só estão disponíveis a partir do plano Construa. Confira o plano dos dois lados antes de contratar qualquer coisa.
A ferramenta de automação no meio
Se ninguém do seu time programa, é por aqui que vale começar. A automação recebe o aviso do webhook da INK e joga o dado na outra ferramenta, com configuração em tela em vez de código. Ela aparece em todos os cinco casos abaixo.
-
n8n. Mais flexível e dá para rodar no seu próprio servidor. Boa escolha para fluxo com muitas condições.
-
Zapier. O mais simples de começar, com muitos aplicativos já prontos do outro lado.
Nas três, a INK entra como webhook de entrada e chamada de API na saída, não como aplicativo pronto na lista.
1. Avisar o cliente sobre o status da entrega
Para quem recebe muito "onde está meu pedido".
O que você precisa: webhook nos eventos de entrega, uma plataforma de WhatsApp com provedor oficial ou uma ferramenta de email, e uma automação no meio.
Como montar: cadastre os eventos de entrega que interessam. Nem todos precisam virar mensagem, e despachado, saiu para entrega e entregue costumam dar conta. Cada aviso traz o pedido e o estágio, e a automação dispara a mensagem correspondente.
Sobre o WhatsApp: ele não é acessado direto pela Meta. Você contrata um provedor homologado, chamado BSP, que ativa e configura a conta, e as mensagens saem a partir de modelo aprovado. Take Blip e Zenvia são brasileiros e atendem desde PME até grande operação. 360dialog tem modelo mais direto com a Meta. Twilio e Infobip são globais e mais indicados para operação internacional. A lista oficial e atualizada fica no diretório de parceiros da Meta. Usar intermediário não homologado aumenta o risco de bloqueio do seu número.
O que observar: mensagem em excesso irrita e faz o cliente bloquear o contato. E o evento de falha na entrega merece tratamento diferente dos outros, porque ali a mensagem automática resolve pouco e a pessoa quer falar com alguém. Vale mandar esse para o seu atendimento em vez de para o cliente.
Junto com esse caso vale ligar os avisos que não são para o cliente e sim para o seu time: pedido com produto personalizado parado há mais de 24 horas, item alterado na janela de 2 horas e endereço de entrega alterado. Uma automação joga esses três no canal onde o time já trabalha.
2. Recuperar cliente e pedido que ficaram no caminho
Para quem perde venda de gente que chegou perto de fechar.
O que você precisa: webhook nos eventos de carrinho abandonado, cartão não autorizado e Pix ou boleto expirado, uma ferramenta de email ou de WhatsApp e uma automação no meio.
Como montar: são três situações diferentes e cada uma pede uma mensagem própria.
-
Carrinho abandonado: o aviso traz os itens que ficaram no carrinho, então a mensagem pode mostrar exatamente o que a pessoa deixou para trás em vez de um lembrete genérico.
-
Cartão não autorizado: a pessoa já decidiu comprar e o problema foi o meio de pagamento. Oferecer outra forma resolve boa parte.
-
Pix ou boleto expirado: aqui basta gerar de novo. É a recuperação mais fácil das três e a que menos gente faz.
Do lado da ferramenta de email ou CRM, a API INK também entrega a sua base de clientes e os contatos que se cadastraram na newsletter, o que permite montar a audiência antes de ligar a régua. No Mailchimp, a API cria e atualiza contatos, aplica etiquetas e aceita eventos de fora como gatilho de automação. No RD Station Marketing, cada aviso da INK entra como uma conversão com identificador próprio, então "carrinho abandonado" e "pedido entregue" viram gatilhos diferentes lá dentro.
O que observar: comece pelos dois de pagamento. São menos mensagens, o público é menor e a conversão é maior que a de carrinho, porque a intenção de compra já estava confirmada. Deixe o carrinho abandonado para depois, quando você já souber que o fluxo funciona.
3. Emitir a nota fiscal do seu lucro no Tiny
Para quem precisa emitir nota da sua parte da venda.
A INK emite a nota referente ao valor do produto. A nota do seu lucro é sua responsabilidade, e esse é o caso em que a integração poupa mais trabalho repetitivo.
O que você precisa: credencial de API com permissão de consultar pedidos e clientes, webhook no evento de pagamento confirmado, o Sistema ERP da Olist, o antigo Tiny, com API liberada, e uma automação no meio.
Como montar: o aviso de pagamento confirmado chega já com o seu lucro naquele pedido, que é justamente o valor que a nota precisa. A automação recebe o aviso, consulta pela API INK os dados do pedido e do comprador, e lança tudo no Olist, que emite a nota. A API do Olist cobre produtos, estoque, pedidos, notas fiscais, contas a pagar e receber e contatos, então o mesmo fluxo pode alimentar o seu financeiro com o saldo, o extrato, os saques e as antecipações que a API INK devolve.
O que observar: fale com a sua contabilidade antes de ligar. Como classificar essa nota, qual natureza de operação usar e o que informar depende do seu regime, e isso não é algo que a INK possa definir para você. Rode com um pedido e confira a nota emitida antes de deixar o fluxo automático.
4. Dashboard de análise no Looker Studio
Para quem exporta relatório toda semana e refaz a mesma planilha.
O que você precisa: credencial de API só de consulta, uma planilha ou banco de dados, o Looker Studio e uma automação.
Como montar: a automação puxa os dados pela API INK num horário fixo, uma vez por dia costuma bastar, e escreve numa planilha. O Looker Studio não conversa direto com a API INK, ele lê essa planilha e monta os gráficos em cima dela. Se quiser dado em tempo real, use o webhook de pedido criado e faça a automação escrever uma linha a cada aviso.
O que dá para analisar: a API devolve pedidos com filtro por status de entrega, clientes, carrinhos abandonados, produtos, coleções, promoções e o financeiro da loja. Dá para cruzar venda por produto, por coleção, por promoção e por período, e ver quanto de carrinho abandonado virou venda.
O que observar: use credencial só de consulta. Esse fluxo não precisa alterar nada na loja, e uma credencial sem permissão de alteração não consegue estragar nada mesmo se algo der errado.
5. Criação de produtos em massa
Para quem vai subir uma coleção inteira e não quer cadastrar um por um no painel.
Esse caso é diferente dos outros quatro. Não existe ferramenta de mercado que queira criar produto na sua loja INK, porque aqui não é a INK conversando com outro sistema, é a sua loja fazendo em lote o que você faria no painel um por um. Então não tem nome de ferramenta para citar do outro lado.
O que a API permite: criar, editar e excluir produtos, com a arte informada por endereço de imagem; criar, editar e excluir categorias e coleções, incluindo kit e vitrine; criar, editar e excluir promoções. Programar campanha por horário e desligar tudo no fim entra aqui também.
O que você precisa: credencial de API com permissão de alterar produtos, as artes publicadas em endereços de imagem acessíveis, uma planilha com os dados e uma automação.
Como montar:
-
Monte a planilha com uma linha por produto, incluindo o endereço da arte.
-
Se ninguém do seu time programa, peça a uma ferramenta de IA, como Claude ou ChatGPT, o fluxo de n8n ou o script que faz isso, passando o endereço da documentação, developers.reserva.ink, para ela seguir o formato certo.
-
Cole o resultado na automação e rode ali. A ferramenta de IA escreve, ela não executa.
O que observar: rode com uma linha primeiro e confira o produto no painel antes de soltar a planilha inteira. A arte vai por endereço de imagem, não por envio de arquivo. Os mockups são gerados depois da criação, então o produto não aparece completo no mesmo instante. E a INK não consegue dar suporte a script ou fluxo que você gerou: o suporte cuida da API e do webhook, do lado da INK.
Por onde começar
Se é a sua primeira integração, o caso 4 é o melhor primeiro passo. Ele usa credencial só de consulta, não mexe em nada da loja, e você já sai com resultado visível. Depois disso os outros ficam mais fáceis, porque a parte chata, entender como a API devolve os dados da sua loja, já está feita.
O caminho é sempre o mesmo:
-
Confirme que a sua loja está no plano Inkrível.
-
No seu painel, clique em Credenciais de API e gere uma credencial, marcando só o que a conexão precisa fazer.
-
Se a ideia envolve reagir a acontecimentos, cadastre também os webhooks dos eventos que interessam.
-
Mande a credencial e o endereço da documentação, developers.reserva.ink, para quem vai montar a conexão.