Ainda não existe um app da Omnifox na loja do Zapier: você não vai encontrá-lo na busca nem vai ver um botão de "Conectar conta". O que existe, e funciona agora mesmo, é um webhook de saída assinado, um conector de ações e uma API REST completa. Com isso, e com o bloco genérico "Webhooks by Zapier", você monta o mesmo Zap em minutos.
7 dias grátis. Sem cartão de crédito. O acesso à API está incluído a partir do plano Crece.
Procure "Omnifox" na loja do Zapier e você não vai encontrar. Ainda não publicamos um app nativo lá, então não existe um gatilho com nome próprio, como "Nova conversa na Omnifox", para escolher em uma lista, nem uma conexão de conta por OAuth com um clique. Preferimos dizer isso aqui, antes que você descubra no meio da configuração.
O que existe, e é o que qualquer app publicado do Zapier usa por baixo dos panos, é a infraestrutura: webhooks de saída assinados para que o Zapier reaja ao que acontece na Omnifox, um conector de ações para que o Zapier escreva de volta, e uma API REST completa para qualquer coisa que nenhum dos dois cubra. O Zapier tem um bloco genérico exatamente para isso — "Webhooks by Zapier" — e com dois dos seus passos, "Catch Hook" e "Custom Request", você monta o mesmo fluxo que teria com um app nativo.
A diferença prática é que configurar isso leva dez minutos em vez de dois cliques. O resultado final, porém, é o mesmo.
Ainda sem app nativo, mas com webhooks assinados, um conector de ações e a API REST completa: hoje a conexão se faz com dois passos do "Webhooks by Zapier".
O mesmo que um botão de "Conectar" resolveria, montado com dois passos genéricos do Zapier.
Quando chega uma mensagem, é criado um contato, uma conversa é atribuída, um agendamento é marcado, um SLA é descumprido ou um pedido é pago, a Omnifox pode avisar o Zapier na hora. São 49 eventos distintos, não um genérico "algo mudou".
O conector de ações já entende cinco operações: criar contato, atualizar contato, buscar contato, adicionar etiqueta e enviar uma mensagem. Um passo "Custom Request" no seu Zap é tudo que você precisa.
Todo webhook sai com uma assinatura HMAC-SHA256 no cabeçalho X-Omnifox-Signature, para que quem o receba possa verificar que o evento realmente veio da Omnifox e não de alguém que adivinhou a URL.
Se as 5 ações do conector não forem suficientes, qualquer endpoint da API REST — contatos, conversas, mensagens, etiquetas, campanhas, agendamentos — fica disponível com um token, documentado em /docs.
O mesmo Zap pode escutar um evento da Omnifox e, mais adiante na mesma automação, escrever de volta: por exemplo, marcar a conversa com uma etiqueta depois de criar o registro no seu CRM.
As assinaturas de webhook são criadas, pausadas e excluídas na sua própria conta. Não é preciso nos pedir permissão para ativar ou mudar um evento.
O mesmo resultado que um app nativo daria, montado com dois passos genéricos do Zapier.
Na Omnifox, vá em Configurações → Integrações e ative o cartão "Zapier": ele fornece uma URL de entrada e uma chave de assinatura. Se você for precisar do catálogo completo de eventos ou da API, gere também um token em Configurações → Chaves de API.
No seu Zap, adicione o passo "Webhooks by Zapier" → "Catch Hook" e copie a URL que o Zapier fornece. Cole-a no campo de saída do cartão "Zapier" (para os 8 eventos selecionados) ou crie uma assinatura em Configurações → Webhooks se precisar de qualquer um dos 49 eventos do catálogo completo.
Para que o Zap escreva de volta, adicione outro passo "Webhooks by Zapier" → "Custom Request" (POST) apontando para a URL de entrada, com a assinatura HMAC do corpo no cabeçalho X-Omnifox-Signature e um JSON com a ação: create_contact, update_contact, find_contact, add_tag ou send_message. Para qualquer outra operação, aponte o mesmo passo para um endpoint de /docs com seu token no cabeçalho Authorization.
Dispare o evento real na Omnifox — envie uma mensagem de teste ou crie um contato — e confirme que o Zapier capturou no passo de teste. Ative o Zap e repita o processo para cada evento ou ação diferente que você precisar: cada um vive no seu próprio Zap.
Preferimos que você saiba disso antes de configurar qualquer coisa.
Não aparece no catálogo do Zapier: sem gatilhos com nome próprio, sem ações com nome próprio, sem conexão de conta por OAuth com um clique. O que existe é a infraestrutura genérica — webhooks e API — e o bloco "Webhooks by Zapier" para falar com ela.
O passo "Custom Request" para o nosso conector entende criar contato, atualizar contato, buscar contato, adicionar etiqueta e enviar uma mensagem. Para o resto — fechar uma conversa, criar um pedido, atualizar um campo personalizado — é preciso chamar a API REST diretamente com um token, não o conector.
O Zapier não vem de fábrica com um passo que monte um HMAC-SHA256. Se você quiser validar a assinatura do webhook do lado do Zapier antes de agir, precisa de um passo "Code by Zapier". Se preferir evitar isso, o conector de ações funciona do mesmo jeito com a assinatura calculada do lado da Omnifox, e para a API REST basta o token no cabeçalho Authorization, sem assinatura para calcular.
As assinaturas de webhook e o conector de ações estão vinculados ao espaço de trabalho onde foram criados. Se você administra vários espaços, precisa de um Zap — e uma URL — para cada um.
O acesso à API — de onde saem os webhooks e onde vive o conector de ações — não está incluído nos planos Lite, Impulsa nem Conecta. Está incluído a partir do plano Crece. Se você está em um plano menor, a conexão com o Zapier fica pausada até você fazer upgrade, não quebrada.
Publicar na loja do Zapier com gatilhos e ações com nome próprio é algo que temos planejado, não algo que existe hoje. Se isso está te bloqueando, escreva para nós: saber quem precisa é o que faz isso subir de prioridade.
Nada disso é letra miúda que aparece depois de pagar: o cartão "Zapier", os webhooks e a API funcionam do mesmo jeito no plano de teste grátis, desde que o plano inclua acesso à API.
Outra pergunta? [email protected]
Webhooks assinados, um conector de ações e a API REST completa. 7 dias grátis para testar, sem cartão.