Integração com Zapier

Zapier e Omnifox o guia honesto de como conectá-los hoje

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.

49
eventos que podem disparar um Zap
5
ações prontas para usar sem escrever código
0
apps da Omnifox na loja do Zapier, por enquanto
Primeiro, sem rodeios

Por que não existe um botão de "Conectar com o Zapier"

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.

Em uma frase

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".

  • 49 eventos da Omnifox podem disparar um Zap
  • 5 ações já prontas para um Zap escrever na Omnifox
  • Toda a API REST disponível se você precisar de mais do que isso
  • O app nativo está no roadmap — escreva para nós e ele sobe de prioridade
Por que vale a pena mesmo assim

O que você já pode automatizar sem esperar pelo app nativo

O mesmo que um botão de "Conectar" resolveria, montado com dois passos genéricos do Zapier.

Dispare Zaps com eventos reais

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".

Escreva de volta sem programar

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.

Assinado, não só enviado

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.

API REST completa por trás

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.

Funciona nos dois sentidos

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.

Você mesmo gerencia, sem chamados no meio do caminho

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.

Como se conecta hoje

Seu primeiro Zap funcionando em quatro passos

O mesmo resultado que um app nativo daria, montado com dois passos genéricos do Zapier.

1

Consiga suas credenciais

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.

2

Monte o gatilho: Omnifox → Zapier

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.

3

Monte a ação: Zapier → Omnifox

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.

4

Teste e publique o Zap

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.

O estado real, sem enfeites

O que ainda não temos com o Zapier

Preferimos que você saiba disso antes de configurar qualquer coisa.

Não há app da Omnifox na loja do Zapier

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 conector de ações cobre 5 operações, não o CRM inteiro

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 calcula a assinatura HMAC sozinho

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.

Cada Zap escuta um único espaço de trabalho

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.

Os webhooks e a API exigem o plano Crece ou superior

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.

O app nativo está no roadmap

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.

FAQ

Perguntas frequentes

Não, ainda não. Não existe nenhum app da Omnifox publicado no catálogo do Zapier. O que existe, e funciona hoje, é um conector de ações já pronto dentro da Omnifox, mais webhooks de saída e uma API REST completa, que se conectam com os passos genéricos "Webhooks by Zapier" de qualquer Zap.
Com o passo "Webhooks by Zapier" → "Catch Hook". Você copia a URL que o Zapier fornece e cola como saída no cartão "Zapier" em Configurações → Integrações (para uma lista curta de 8 eventos) ou em uma nova assinatura em Configurações → Webhooks (para qualquer um dos 49 eventos do catálogo completo: mensagens, conversas, contatos, agendamentos, pedidos, chamadas, pagamentos e mais).
Com "Webhooks by Zapier" → "Custom Request" apontando para a URL de entrada do conector, assinando o corpo com a chave que a Omnifox te deu. O conector entende cinco ações: criar contato, atualizar contato, buscar contato, adicionar etiqueta e enviar uma mensagem. Para qualquer outra coisa, o mesmo passo pode chamar qualquer endpoint da nossa API REST com um token no cabeçalho Authorization.
Não, se os 8 eventos selecionados e as 5 ações do conector cobrirem o que você precisa: são dois passos de arrastar e soltar no Zapier, sem código. Se você precisar de algo fora dessa lista curta — um evento mais específico ou uma operação que o conector não cobre — vai estar montando o corpo de uma requisição HTTP na mão, e aí já vale ter alguém de tecnologia por perto.
Eles são assinados. Todo webhook de saída carrega um HMAC-SHA256 do corpo no cabeçalho X-Omnifox-Signature, calculado com uma chave que só você tem. Verificá-lo do lado do Zapier exige um passo extra de "Code by Zapier"; se você não adicionar isso, mesmo assim ninguém consegue adivinhar a URL exata da sua assinatura nem a chave do conector de ações.
49 eventos distintos para disparar Zaps — mensagens, conversas, contatos, notas, chamadas, agentes, etiquetas, agendamentos, pedidos, fluxos, campanhas, assinaturas e pagamentos — e 5 ações já prontas para um Zap escrever de volta: criar contato, atualizar contato, buscar contato, adicionar etiqueta e enviar uma mensagem. Todo o resto é coberto pela API REST completa, documentada em /docs.
Sim. Os webhooks de saída e a API REST — que são a base de tudo isso — estão incluídos a partir do plano Crece. Nos planos Lite, Impulsa e Conecta, a conexão com o Zapier ainda não está disponível.
Está no roadmap, ainda sem data. Se isso é algo que você precisa para decidir, escreva para [email protected]: cada pedido conta para priorizar.

Outra pergunta? [email protected]

Conecte a Omnifox com o Zapier hoje mesmo, sem esperar pelo app nativo

Webhooks assinados, um conector de ações e a API REST completa. 7 dias grátis para testar, sem cartão.

Fale conosco no WhatsApp