Cinco coisas para montar com a API INK e o webhook
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:
1. Monte a planilha com uma linha por produto, incluindo o endereço da arte.
2. 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.
3. 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:
1. Confirme que a sua loja está no plano Inkrível.
2. No seu painel, clique em Credenciais de API e gere uma credencial, marcando só o que a conexão precisa fazer.
3. Se a ideia envolve reagir a acontecimentos, cadastre também os webhooks dos eventos que interessam.
4. Mande a credencial e o endereço da documentação, developers.reserva.ink, para quem vai montar a conexão.