Ir para o conteúdo

WooCommerce

Como configurar a integração?

Códigos de rastreio

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

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

Dependemos das informações de boleto bancário dentro dos comentários dos pedidos. Infelizmente algumas plataformas de checkout não adicionam essa informação, impossibilitando 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 ele, você pode emitir os boletos através dela.

Estados customizados

Suportamos somente os estados que já são o padrão do WooCommerce, você pode ver eles na documententação oficial deles 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? Temos uma integração para isto também, veja mais aqui.

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:

dashboard-option-integration

Na página, clique em Criar loja:

create-integration

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

store-integration

Na Plataforma, selecione a opção com o nome da integração, como demonstra na imagem acima.

Dentro do WooCommerce

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

option-painel

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

configuration

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:

option-advanced

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

option

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

create-option

Agora, terá 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 dois webhooks com Tópico diferente: Pedido Criado e Pedido Atualizado.

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

option-topic

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

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

Importante

Nossa aplicação faz o mapeamento apenas dos eventos-padrão do WooCommerce que podem ser encontrado 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):

panel-templates

Clique no botão Personalizar template:

button-template

Você será redirecionado para a página do template de Eventos customizados. Agora, você pode visualizar, atualizar a mensagem desse template

template-message

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:

checklist

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 ele 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.
Prioridade no caminho feliz Nome da notificação Como reconhecemos o evento?
WooCommerce
- Eventos customizados (que não são os padrões do WC) O campo status precisa ser diferente dos seguintes valores: canceled, cancelled, completed, failed, on-hold, pending, processing ou refunded.
Eventos da funcionalidade do lembrador de boletos
1 Boleto expira hoje Este evento é gerado internamente pelo Notificações Inteligentes.
1 Boleto expira amanhã Este evento é gerado internamente pelo Notificações Inteligentes.
1 Boleto expirou (um dia após o vencimento) Este evento é gerado internamente pelo Notificações Inteligentes.
Eventos relacionados ao pedido
1 Pagamento pendente O campo status precisa ter algum dos seguintes valores: pending.
2 Aguardando pagamento via PIX O campo payment_method precisa ser parecido com (?i)PIX(?-i) e o campo status precisa ter algum dos seguintes valores: on-hold.
2 Pedido com boleto (Boleto impresso) O campo payment_method precisa ter algum dos seguintes valores: appmax-billet, gerencianet_oficial, ipag-gateway_boleto, juno-bank-slip, woo-mercado-pago-ticket, mercadopago, woo-moip-official, woo-mundipagg-payments, pagarme-banking-ticket, paghiper, paghiper_billet, pagseguro, picpay ou wc_yapay_intermediador_bs e o campo status precisa ter algum dos seguintes valores: on-hold.
2 Pedido em espera com pagamento na entrega O campo payment_method precisa ter algum dos seguintes valores: cod e o campo status precisa ter algum dos seguintes valores: on-hold.
2 Pedido em espera usando cartão de crédito Qualquer um dos casos abaixo:
  • O campo payment_method precisa ter algum dos seguintes valores: appmax-credit-card, loja5_woo_cielo_webservice, ipag-gateway_cc, ipag-gateway, juno-credit-card, woo-mercado-pago-custom, pagarme-credit-card, paypal, paypal-brasil-plus-gateway, rede_credit ou wc_yapay_intermediador_cc e o campo status precisa ter algum dos seguintes valores: on-hold.
  • O campo payment_method precisa ser parecido com ^ebanx e o campo status precisa ter algum dos seguintes valores: on-hold.
2 Pedido em espera usando depósito bancário O campo payment_method precisa ter algum dos seguintes valores: bacs ou itau-shopline e o campo status precisa ter algum dos seguintes valores: on-hold.
3 Processando O campo status precisa ter algum dos seguintes valores: processing.
4 Pagamento completado O campo status precisa ter algum dos seguintes valores: completed.
5 Pedido com falha O campo status precisa ter algum dos seguintes valores: failed.
6 Pedido cancelado (pagamento com falha) O campo status precisa ter algum dos seguintes valores: canceled ou cancelled.
7 Estorno do pagamento feito O campo status precisa ter algum dos seguintes valores: refunded.

Aprenda mais sobre o algoritmo do caminho feliz neste artigo

Ficou alguma dúvida?

Caso tenha ficado com dúvidas, mande um email para o nosso suporte em [email protected] ou no Chat disponível dentro do app.


Última atualização: 5 de abril de 2021 15:33:20