Como integro minha base de clientes ao Google Sheets pela API de Tickets?

Quer saber como integrar sua base de clientes ao Google Sheets pela API de Tickets da Octadesk? Vem com a gente que vamos te ajudar nisso. o/

Na Octadesk cada vez que um e-mail é criado ou uma conversa por chat é iniciada por um novo cliente, ele já fica registrado no sistema. Além disso, é também possível inserir novos clientes manualmente no seu ambiente através do atalho "Gestão de Pessoas" no menu lateral esquerdo.

Todos esses clientes que forem criados no seu ambiente podem ser salvos em uma planilha do Google Sheets. Assim, você pode utilizar as informações deles para enviar e-mail marketing ou gerar relatórios específicos para sua necessidade.

Abaixo, veja o rápido passo a passo de como fazer a integração do Octadesk com o Google Sheets:

Importante: Para que a integração funcione, siga todos os passos a seguir exatamente como explicado!

Passo 1: Acesse seu Google Drive e crie uma nova Planilha Google;

Passo 2: Renomeie a aba dessa planilha para clientes (exatamente como está escrito, com "c" minúsculo);

Passo 3: Entre no atalho "Ferramentas > Editor de Script";

Passo 4: Copie o código abaixo na tela:

function doGet(e) {

 // Todo

}

function doPost(e) {

 var lead = JSON.parse(e.postData.contents);

 gravarMensagem(lead);

}

function gravarMensagem(mensagem) {

 var celulas = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('clientes');

 var cabecalho = celulas.getRange(1, 1, 1, 11);

 cabecalho.setValues([['Data', 'IsEnabled', 'Id', 'Type', 'RoleType', 'PermissionType', 'ParticipantPermission', 'Name', 'Email', 'PhoneContacts', 'Organizations.Name']]);

 var trava = LockService.getScriptLock();

 trava.waitLock(2000);

 celulas.appendRow([new Date(),

                    mensagem.IsEnabled,

                    mensagem.Id,

                    mensagem.Type,

                    mensagem.RoleType,

                    mensagem.PermissionType,

                    mensagem.ParticipantPermission,

                    mensagem.Name,

                    mensagem.Email,

                    mensagem.PhoneContacts.map(function(h){ return h.Number }).join(", "),

                    mensagem.Organizations.map(function(h){ return h.Name }).join(", ")]);

 SpreadsheetApp.flush();

 trava.releaseLock();

}

Deve ficar parecido com o exemplo abaixo:

Passo 5: A parte difícil já foi!

Agora basta ir no atalho "Publicar > Implantar como aplicativo da web..." para publicar seu aplicativo.

• Dê um nome para o projeto (ex. Versão 1);

• No campo "Quem tem acesso ao aplicativo" deixe marcado "Qualquer pessoa, mesmo anônima";

• Após clicar em "Implementar", siga os passos que o Google solicitar para dar a autorização necessária;

• Ao fim da publicação será informado a URL do seu aplicativo da web. Copie essa URL.
  

Passo 6: Para finalizar, é preciso informar ao Octadesk que ele envie as informações do cliente para essa planilha que acabamos de configurar. Para fazer isso, acesse seu Octadesk e procure no menu lateral esquerdo a área de Tickets, desça a barra até a seção "Geral" e clique em "Webhook";

Passo 7: Clique em "Cadastre seu primeiro webhook".

Você deverá criar dois eventos:

1. Evento = Criação de clientes;

2. Evento = Atualização de clientes.

No campo URL desses dois eventos, cole a URL do seu aplicativo que você copiou e clique em "Salvar".

Pronto! Todas as vezes que um novo cliente for criado ou atualizado no seu ambiente, suas informações serão automaticamente salvas na planilha do Google Sheets que você acabou de configurar. 😉