Como integrar a sua plataforma do JivoChat a outras ferramentas web via Pluga Webhooks

Integrar o JivoChat com outras ferramentas web (como, por exemplo, Google Sheets, RD Station ou Pipedrive) via Pluga Webhooks é muito simples. Basta seguir este passo a passo:

1. Acesse a página de automatizações do Pluga Webhooks e escolha qual será a ferramenta que receberá os dados do JivoChat;

2. Após escolher a automatização e clicar em "Fazer essa automatização", nomeie o Pluga Webhooks que será usado para integrar o seu JivoChat. Depois clique em "Gerar Pluga Webhook", conforme mostrado abaixo:

f41e4f125d45dcbb58947843a9308824.gif

3. Copie a URL que você acabou de gerar;

Agora você precisará configurar o envio de dados no seu JivoChat. Para fazer isso é muito fácil.

4. Faça login na sua conta do JivoChat através do link: https://app.jivosite.com/;

5. No menu lateral, clique em “Configurações” > “Canais” > “Configurações”, como mostra o print abaixo:

pasted_image_0.png

6. Em seguida, acesse o menu “Configurações de integração para desenvolvedores”, ative os Webhooks e insira a URL da Pluga (que você copiou no passo 3) no campo “URL para Webhooks”.

pasted_image_0__1_.png

Ótimo! Agora que está tudo certo no JivoChat;

7. Volte para a sua automatização na Pluga e clique em "Continuar":

pasted_image_0__2_.png

 

8. Em "Modelo de envio dos dados para notificação" cole o JSON referente ao gatilho que você quer enviar para a sua ferramenta de destino e clique em "Continuar". Veja o exemplo:

1405bfa34634325ef99a8e7a67cad5f5.gif

Separamos para você alguns exemplos de JSON do JivoChat prontinhos para você copiar e colar na Pluga. Veja:

  • chat_accepted - Um operador aceitou uma requisição de chat no aplicativo 
{
    "event_name": "chat_accepted",
    "chat_id": 4321,
    "widget_id": "3369",
    "visitor": {
        "name": "John Smith",
        "email": "email@example.com",
        "phone": "+14084987855",
        "number": "3553",
        "description": "Description text",
        "social": {},
        "chats_count": 1
    },
    "agent": {
        "id": "2596",
        "name": "Thomas Anderson",
        "email": "agent@jivosite.com",
        "phone": "+14083682346"
    },
    "department": {
        "id": 234,
        "name": "Sales"
    },
    "session": {
        "geoip": {
            "region_code": "CA",
            "country": "United States",
            "country_code": "US",
            "region": "California",
            "city": "San Francisco",
            "latitude": "37.7898",
            "longitude": "-122.3942",
            "organization": "Wikimedia Foundation"
        },
        "utm": "source=google|medium=cpc|content=banner|campaign=campaign_name",
        "utm_json": {
            "source": "google",
            "campaign": "campaign_name",
            "content": "banner",
            "medium": "cpc",
            "term": "..."
        },
        "ip_addr": "208.80.152.201",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.71 Safari/537.36"
    },
    "page": {
        "url": "http://example.com/",
        "title": "Page title"
    }
 }
  • chat_finished - Chat finalizado (um chat foi encerrado por um operador clicando em “Encerrar conversa” no topo do chat, automaticamente por contagem regressiva após um cliente ter saído do site ou após o operador fechar o aplicativo) 
{
    "event_name": "chat_finished",
    "chat_id": 1265,
    "widget_id": "3369",
    "visitor": {
        "name": "John Smith",
        "email": "email@example.com",
        "phone": "+14084987855",
        "number": "3553",
        "description": "Description text",
        "social": {},
        "chats_count": 1
    },
    "agents": [
        {
            "id": "2596",
            "name": "Thomas Anderson",
            "email": "agent@jivosite.com",
            "phone": "+14083682346"
        }
    ],
    "department": {
        "id": 234,
        "name": "Sales"
    },
    "chat": {
        "messages": [
            {
                "timestamp": 1431955090,
                "type": "agent",
                "agent_id": 4092,
                "blacklisted": false
            }
        ]
    },
    "session": {
        "geoip": {
            "region_code": "CA",
            "country": "United States",
            "country_code": "US",
            "region": "California",
            "city": "San Francisco",
            "latitude": "37.7898",
            "longitude": "-122.3942",
            "organization": "Wikimedia Foundation"
        },
        "utm": "source=google|medium=cpc|content=banner|campaign=campaign_name",
        "utm_json": {
            "source": "google",
            "campaign": "campaign_name",
            "content": "banner",
            "medium": "cpc",
            "term": "..."
        },
        "ip_addr": "208.80.152.201",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.71 Safari/537.36"
    },
    "page": {
        "url": "http://example.com/",
        "title": "Page title"
    }
 }
  • offline_message - Uma mensagem offline foi enviada pelo formulário de contato enquanto os operadores estavam offline 
{
    "event_name": "offline_message",
    "widget_id": "3369",
    "visitor": {
        "name": "John Smith",
        "email": "email@example.com",
        "phone": "+14084987855",
        "number": "3553",
        "description": "Description text",
        "social": {},
        "chats_count": 1
    },
    "offline_message_id": "3515",
    "message": "Message text",
    "session": {
        "geoip": {
            "region_code": "CA",
            "country": "United States",
            "country_code": "US",
            "region": "California",
            "city": "San Francisco",
            "latitude": "37.7898",
            "longitude": "-122.3942",
            "organization": "Wikimedia Foundation"
        },
        "utm": "source=google|medium=cpc|content=banner|campaign=campaign_name",
        "utm_json": {
            "source": "google",
            "campaign": "campaign_name",
            "content": "banner",
            "medium": "cpc",
            "term": "..."
        },
        "ip_addr": "208.80.152.201",
        "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/54.0.2840.71 Safari/537.36"
    },
    "page": {
        "url": "http://example.com/",
        "title": "Page title"
    }
 }

🤖 Dica: Você pode montar o seu próprio JSON e/ou conferir outros exemplos na Documentação do JivoChat. Confira aqui.

9. Mapeie os campos e personalize as informações que serão enviadas pelo JivoChat para a sua ferramenta de destino, como mostra o gif abaixo:

pasted_image_0__3_.png

10. Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎

pasted_image_0__4_.png

Para mais informações sobre como configurar sua API do JivoChat através do Webhook (Postback), você pode olhar a documentação do JivoChat.

Ainda está com dúvidas ou gostaria de ver o passo a passo de alguma automatização específica aqui em nossa Central de Ajuda? É só solicitar atendimento e mandar uma mensagem pra gente! Queremos saber de você. =)

Esse artigo foi útil?
Usuários que acharam isso útil: 1 de 3