Octadesk

Como faço para integrar o Octadesk com a Shopify?

AM

Escrito por Anne Machado

atualizado

Escolha a seção


Olá! Se você tem uma loja virtual na Shopify e quer turbinar a comunicação com seus clientes, este guia é para você. Vamos aprender a integrar a Octadesk com a Shopify de forma simples e prática, automatizando mensagens importantes para o seu negócio.

Neste artigo, vamos cobrir três cenários essenciais:

  1. Recuperação de Carrinho Abandonado: O Shopify Flow detecta o carrinho abandonado e envia uma mensagem ao WhatsApp pela Octadesk.

  2. Atualização de Status de Pedido: O Shopify Flow percebe uma mudança no pedido (como envio) e notifica pelo WhatsApp usando o Octadesk.

  3. Consulta de Status de Pedido pelo Bot: A Octadesk busca informações na Shopify via API.

Cenário 1: Recuperação de Carrinho Abandonado (Shopify Flow → Octadesk)

Neste fluxo, o Shopify Flow é o "cérebro" que detecta o carrinho abandonado e envia os dados para a Octadesk usando uma ação de "Enviar HTTP request".

Como Funciona?

  • O cliente adiciona produtos ao carrinho e abandona o checkout.

  • O Shopify Flow, após um período que você define, identifica esse evento como um "carrinho abandonado".

  • O Flow, então, executa uma ação: ele dispara uma notificação (uma API) contendo os dados do carrinho para a Octadesk.

  • A Octadesk dispara uma mensagem personalizada de WhatsApp para o cliente.


Passo a Passo da Configuração

1. Dentro do Octadesk

Primeiro, você precisa de uma chave de API na Octadesk para usar no Shopify Flow.

  1. Acesse sua conta na Octadesk e vá em Configurações > API.

  2. Clique em Gerar API Key, siga os passos e salve a Hash e a Base URL para usarmos futuramente.

O segundo passo é ter uma Modelo de mensagem aprovada na meta.

  1. Acesse sua conta na Octadesk e vá em Configurações > Modelos de mensagem. 

  2. Crie uma mensagem da sua preferência, deixando uma variável genérica para receber o link do checkout. Exemplo a imagem a seguir.

  3. Após aprovação da mensagem modelo, copie o ID que se encontra abaixo do nome do modelo, pois iremos usar ele futuramente.

2. Crie o Fluxo de Automação no Shopify Flow

Agora, vamos configurar a automação na Shopify para enviar a mensagem usando a API da Octadesk.

  1. No painel de administração da Shopify, vá para Apps > Flow.

  2. Clique em Criar fluxo de trabalho.

  3. Escolha um acionador (trigger). Selecione "Customer abandons checkout".

  4. Clique no sinal de + e adicione uma ação. Selecione "Send an HTTP request".

  5. Configure a ação:

    • HTTP method: POST

    • URL: Cole o Base URL que você copiou da Octadesk e adicione no final “/chat/send-template". (Exemplo de como ficaria: https://subdominio.api001.octadesk.services/chat/send-template)

    • Em Headers adicione:

      • X-API-KEY: Cole a Hash que você copiou no Octadesk.

      • accept: application/json

      • content-type: application/json

Ficará algo assim:

:



Ainda dentro da configuração Send HTTP request no campo de Body você vai mapear os dados do carrinho abandonado para o formato que a Octadesk precisa para enviar uma mensagem. É aqui que o Flow se destaca!

{

  "origin": {

    "contact": {

      "channel": "whatsapp",

      "code": "+5511999999999"

    }

  },

  "target": {

      "contact": {

           "channel": "whatsapp",

           "code": {% for addresses_item in abandonment.customer.addresses %} "{{addresses_item.phone}}" {% endfor %}, 

           "name": "{{abandonment.customer.firstName}}"

       }

  },

  "content": {

      "templateMessage": {

         "id": "[AQUI O ID DA MENSAGEM]",

              "variables": [

                    {

                          "key": "var-1",

                          "value": "{{abandonment.abandonedCheckoutPayload.abandonedCheckoutUrl}}"

                    }

             ]

         }

     },

  "options": {

    "automaticAssign": false

  }

}




Ponto importante, algumas vezes o shopify envia o telefone com ou sem +55 (código do país), para o Octa funcionar é necessário que tenha o código do país. Então deve-se adicionar uma verificação e adaptar o Send HTTP request para que funcione em todos os casos.

  1. Dê um nome ao seu fluxo, como "Fluxo - Recuperar Carrinho Abandonado", e clique em Ativar (Turn on) no canto superior direito.

Cenário 2: Atualização de Status de Pedido (Shopify Flow → Octadesk)

O processo é o mesmo do carrinho abandonado, mas com um acionador diferente no Shopify Flow. A lógica é: "se o pedido foi atualizado, notifique a Octadesk".

Passo a Passo da Configuração

1. Configuração dentro do Octadesk

  1. Siga a mesma instrução do processo de carrinho abandonado, da etapa 1. Dentro do Octadesk

2. Crie o Fluxo de Automação no Shopify Flow

  1. No Shopify Flow, clique em Criar fluxo de trabalho.

  2. Escolha o acionador "Order updated" ou "Fulfillment created" (este é ideal para envios).

  3. Adicione a ação "Send an HTTP request".

  4. Configure a ação como no cenário anterior, usando a API da Octadesk.

Cenário 3: Validar Status de Pedido no Bot da Octadesk (Octadesk → Shopify)

Este cenário é o inverso dos anteriores. Aqui, a Octadesk busca informações na Shopify usando a API da Shopify, por isso o Shopify Flow não é necessário.

Como Funciona?

  • O cliente interage com o bot da Octadesk e pede para verificar um pedido.

  • O bot solicita o número do pedido.

  • A Octadesk usa a API da Shopify para buscar os dados do pedido.

  • A Shopify devolve o status, e o bot da Octadesk responde ao cliente com a informação.

Passo a Passo da Configuração

1. Crie as Credenciais de API na Shopify

Para a Octadesk "falar" com a Shopify, você precisa de uma chave de acesso.

  1. No painel da Shopify, vá em Configurações > Aplicativos e canais de vendas.

  2. Clique em Desenvolver aplicativos.

  3. Clique em Criar um aplicativo personalizado. Dê um nome, como "Integração Octadesk".

  4. Após a criação, clique em Configurar escopos da API de Admin.

  5. Navegue e selecione as permissões necessárias para a sua integração, como read_orders. A permissão de leitura de pedidos é essencial.

  6. Clique em Instalar aplicativo no canto superior direito.

  7. Você terá acesso ao Token de Acesso da API de Admin. Copie este token e guarde em um local seguro, pois ele só é exibido uma vez.

2. Configure o Fluxo de Atendimento no Bot da Octadesk

  1. Acesse o Estúdio de Automações da Octadesk e edite seu fluxo de atendimento.

  2. Adicione um passo de "Conecte a outro sistema".

  3. Selecione o método POST.

  4. No campo URL, use a URL da API da Shopify para buscar pedidos. A URL será algo como https://SUA_LOJA.myshopify.com/admin/api/2023-01/graphql.json. Lembre-se de substituir SUA_LOJA pelo nome da sua loja.

  5. No campo Cabeçalhos (Headers), adicione um novo header com a chave X-Shopify-Access-Token e o valor do Token de Acesso que você copiou da Shopify.

  6. No campo Corpo (Body), adicione a estrutura da consulta do status do pedido, substituindo o #numero-pedido pela variável que foi salva o valor coletado do número do pedido. (Importante: o shopify pede que seja enviado um # antes do número do pedido, então no octadesk ficará algo como ##variável)


{

    "query": "query { orders(first: 1, query: \"name:##numero-pedido\") { edges { node { id name displayFinancialStatus displayFulfillmentStatus cancelReason fulfillments { status trackingInfo { number url company } estimatedDeliveryAt createdAt } } } } }"

}


  1. Por fim, valide a integração com um pedido valido e salve a resposta para utilizar no fluxo do bot. 


Com essas automações, sua loja virtual estará pronta para oferecer uma experiência de comunicação mais ágil e completa para os seus clientes.