Como integrar com o WooCommerce?

Aprenda a fazer a integração do Notificações Inteligentes com o WooCommerce.

Ainda não usa Notificações Inteligentes? Clique aqui

Como configurar a integração?


Códigos de rastreio.

Descobrimos o código de rastreio do pedido através das seguintes formas:

Utilizando o Shopmaster, buscamos dentro dos campos de notas dos pedidos;
Utilizando o plugin dos Correios do Claudio Sanches;
Utilizando o plugin WooCommerce Shipment Tracking;
Utilizando o plugin do Melhor Envio.

Sempre que for possível fazer o mapeamento, o código de rastreio será disponibilizado dentro das variáveis de template.

Envio de boleto bancário

Para que a gente informe ao cliente sobre o boleto bancário, precisamos que os dados referentes ao método de pagamento estejam presentes nos comentários dos pedidos. Infelizmente, algumas plataformas de checkout não adicionam essa informação - o que impossibilita tecnicamente o funcionamento do envio do boleto.

Hoje, os seguintes sistemas de checkout não enviam os dados do boleto no pedido:

Yampi: temos integração direto com o sistema e, assim, você pode emitir os boletos através desta plataforma.

Estados customizados

Temos suporte apenas para os estados que já são o padrão do WooCommerce - os quais você pode conferir na documentação oficial, clicando aqui.

Caso você utilize estados personalizados, todos serão enviados na notificação Eventos customizados (que não são os padrões do WC).

Carrinho abandonado

Sabia que é possível recuperar carrinhos abandonados no WooCommerce? Pois nós temos uma integração para esta função! Veja mais detalhes sobre ela aqui.

Gateways de pagamento

Reconhecemos os Gateways de pagamento e seus métodos de pagamentos das seguintes formas:

AARIN, suporta PIX;
APPMAX, suporta Boleto Bancário e Cartão de Crédito;
ASAAS, suporta Cartão de Crédito;
BACS, suporta Depósito Bancário;
CIELO, suporta Cartão de Crédito;
COD, suporta Pagamento na Entrega;
EBANX, suporta Boleto Bancário e Cartão de Crédito;
IPAG, suporta Boleto Bancário e Cartão de Crédito;
ITAU SHOPLINE, suporta Depósito Bancário;
IUGU, suporta Cartão de Crédito;
JUNO, suporta Boleto Bancário e Cartão de Crédito;
MERCADO PAGO, suporta Boleto Bancário, Cartão de Crédito e PIX;
MOIP, suporta Boleto Bancário;
MUNDIPAGG, suporta Boleto Bancário;
MULTIBANCO, suporta Cartão de Crédito;
PAGARME, suporta Boleto Bancário e Cartão de Crédito;
PAGHIPER, suporta Boleto Bancário e PIX;
PAGSEGURO, suporta Boleto Bancário e Cartão de Crédito;
PAYPAL, suporta Cartão de Crédito;
PICPAY,suporta Boleto Bancário;
PIX, suporta PIX;
REDE, suporta Cartão de crédito;
STRIPE, suporta Cartão de crédito;
WIRECARD, suporta Boleto bancário;
YAPAY, suporta Boleto bancário e Cartão de crédito.

Caso o gateway de pagamento que você utiliza não esteja aqui, ou algum evento não esteja sendo reconhecido corretamente, entre em contato conosco para avaliarmos a possível implementação.

Como configurar webhook?

Dentro do Notificações Inteligentes

Para criar a integração, acesse a sua conta do Notificações Inteligentes e clique em Lojas:



Na página, clique em Criar loja:



Em seguida, na opção Descrição, é possível dar um apelido para a integração criada:



Na Plataforma, selecione a opção com o nome da integração, dentro da categoria E-Commerce, como demonstrado na imagem abaixo:




Dentro do WooCommerce

Acesse o painel principal da sua loja e procure a opção WooCommerce. Nela, clique em Configurações:



Em seguida, você será redirecionado para a tela de configurações:



No canto superior desta tela, tem a opção Avançado. Clique sobre ela e, então, aparecerão outros campos de configuração, como ilustrado abaixo:



Procure a opção Webhooks e clique sobre ela:



Aparecerão as opções de webhook, clique sobre Adicionar webhook:



Agora, as opções de criação do webhook aparecerão, são elas:

Nome: Defina o nome do webhook;
Status: Defina o status como Ativo;
Tópico: Você vai precisar criar dois webhooks com tópico diferentes, um com Pedido criado e outro com Pedido atualizado;
Segredo: Deixe em branco;
Versão da API: Defina como Interação com o WP REST API v3.

No campo URL de entrega, coloque a URL da integração da WooCommerce que criou no Notificações Inteligentes:

Caso não saiba onde pegar a URL no Notificações Inteligentes, acesse este artigo e siga o passo a passo.


Você vai precisar criar 2 (dois) webhooks com Tópico diferente: Pedido Criado e Pedido Atualizado.

Primeiramente, defina um webhook com o Tópico do tipo Pedido criado:



Após configurar todas as opções, clique em Salvar webhook:



Depois, crie novamente um webhook com o Tópico definido como Pedido atualizado e clique em Salvar webhook.

Pronto! Todos os eventos necessários do webhook foram configurados com sucesso.

Nossa aplicação faz o mapeamento apenas dos eventos-padrão do WooCommerce que podem ser encontrados na documentação oficial.


Tenho eventos customizados, o que faço?

Neste caso, iremos enviar a mensagem de Evento customizado, que se encontra na interface do Notificações Inteligentes.

Então, acesse a sua integração da WooCommerce, desça até templates e procure a opção Eventos customizados (que não são padrões do WC):



Clique no botão Personalizar template:



Você será redirecionado para a página do template de Eventos customizados. Agora, já é possível visualizar e atualizar a mensagem desse template



Para saber mais sobre os templates acesse este artigo.

Pronto! Sua integração foi feita com sucesso! Agora, vamos começar a receber os eventos e, consequentemente, enviar as notificações.


Como sei que deu certo?

Quer conferir se a integração do Notificações Inteligentes foi feita de maneira certa? Então, veja como você pode fazer a confirmação, seguindo estas etapas:

Verifique o checklist dentro da sua loja

Temos um checklist que te ajuda a entender se todas as configurações necessárias para o envio das notificações foram feitas.

Você consegue ter um exemplo do checklist logo abaixo:



Se todas as opções estiverem na cor verde, quer dizer que você fez todos os passos. Então, provavelmente, as notificações já devem estar sendo enviadas.

Acompanhe a tela de relatórios

Na tela de relatórios, seja da integração ou da instância, você consegue ter uma ideia geral das notificações que estão sendo enviadas.

Caso não saiba onde fica esta tela, acesse este artigo para saber como verificar os relatórios.


Verifiquei todos os passos acima e mesmo assim acredito que não esteja funcionando

Nesse caso, temos um checklist mais detalhado que você consegue ver aqui.

Quando as notificações serão disparadas?

Como essa é uma integração instantânea, assim que a plataforma nos enviar as informações, iremos processar e agendar a mensagem na fila de envios. Caso você não saiba o que é uma fila de envios, clique aqui.

Quais são as notificações disponíveis?

Todas as notificações listadas na tabela abaixo estão disponíveis e funcionando. Antes de você conhecê-las, entenda como cada uma delas funciona.

Veja, então, o que significa cada coluna das notificações disponíveis:


Prioridade no caminho feliz: se esta função estiver disponível, ela vai indicar a ordem de envio das mensagens seguindo a lógica do chamado “caminho feliz”. Você pode ler mais sobre ele aqui;
Nome da notificação: é o nome que damos para a notificação dentro do nosso painel;
Como reconhecemos o evento: em algumas integrações, deixamos documentada a maneira como elas são reconhecidas pelo nosso sistema. Isso acontece porque algumas delas podem ser personalizadas. Mas, se o reconhecimento não estiver disponível, pode ficar tranquilo pois isso não afeta qualquer usabilidade do sistema.


Clique na imagem para aumentar




Ainda não usa Notificações Inteligentes? Clique aqui

Atualizado em: 30/10/2023