Todas as categorias > Integrações > API > Como autenticar na API da Huggy

Como autenticar na API da Huggy

CRIADO por Helison Zurc

Com a API da Huggy, você pode, a partir de aplicações externas, gerenciar agentes, contatos, atender seus clientes, enviar e receber mensagens e muito mais funcionalidades.

O primeiro passo é realizado dentro da plataforma Huggy com a criação de um novo aplicativo:

Na painel Huggy acesse Configurações > Developers > Seus aplicativos > Clique em + ADICIONAR APLICATIVO;
Atribua um nome à ele;
Uma tela semelhante à essa será exibida:

Autenticação OAuth

Aqui você poderá configurar uma url de callback e visualizar o client_id e o client_secret que foram gerados automaticamente a partir do momento que você criou o aplicativo na plataforma Huggy.

URL de redirecionamento: insira aqui uma URL de callback que pode ser qualquer endereço, mesmo fictício, a fim de retorno dos dados. Porém, é obrigatório o uso do https:// antes desse endereço;

ex.: https://meuaplicativo.com, https://nomedasuaempresa.com.br, etc.

ID do cliente: ID do aplicativo do cliente. Trata-se de como a API irá identificar a aplicação;
Segredo do cliente: conhecido e utilizado somente pelo aplicativo e pelo servidor de autorização.

Agora, é necessário pegar a URL abaixo e substituir os parâmetros entre chaves { } pelas informações encontradas no app que você criou:

https://auth.huggy.app/oauth/authorize?scope=install_app%20read_agent_profile&response_type=code&redirect_uri={url_de_callback}&client_id={client_id}

onde

{url_de_callback} deverá ser substituído pela url de redirecionamento
{client_id} deverá ser substituído pelo código de ID do cliente

Feito isso, cole a URL que você editou em um navegador de internet e aperte enter. Uma tela semelhante à essa abaixo deverá ser exibida. Clique em Autorizar uso.

Você será redirecionado para uma outra página, onde a Huggy te retornará uma outra URL contendo um code. O link será mais ou menos assim:

https://suaaplicacao.com/?code=def502002a495726a0e19d8b9ee54c2f52f17f093cbd3571c6eb863675b7755fe1a2d125582c870e0fb5be53bfc803a0a2331530034637b46b21bd06b2535557bfbb0e822389fae108c372d5ada3b439c6d404d4d957a1cd6e2ec6867488c2a3469f6708ef253018a96adba2aae3bbce7575c488f3583fb7ced38da07647479c50f179b154ea7e04b845b9c38712dac743053d6170b825e11805f530a3721f0a940fbb9e278fb546ed6f1360963a8f6796e165201ef4abe6bf8c1fa436a6faadd1df17caa6ed607f9bf3d5ec5dd0355ef741f250d24d29877f48913ccf344cedb50dc417f104300fb6cc3214a84279ac3afaa016dd413ee6c0640dc2ee656195053e58c40d74be01e55dcf2174b55f7281fe2099e094cf8303fce22156a9ba283e3ff94649d4e216f6792d88f55cfea4424deb8d9d866f9f033d9447a1d37e41fefa9899ed5e72bcbf6c722a1d0a00c544d3dcbf0ac8a13de7f13705eded3ceaeb285861d741442cd78b0606ae8c18f87e339b4b49c32360a4a8ef33fd5e41ceaa0f0e89477f7324f11f0e728f732c651243b9d147fd3d61215b4a931cf55f7c75

Depois de receber o code, será necessário realizar uma requisição da seguinte forma, a fim de conseguir o access_token:

Método: POST

URL: https://auth.huggy.app/oauth/access_token

Parâmetros:

{
     "grant_type": "authorization_code",
     "redirect_uri": "https://nomedoapp.org/auth/callback",
     "client_id": "APP-bafb4727-c1fe-47af-8cd7-9f43c1a12345",
     "client_secret": "52f9fc0d-daa5-1234-bg36-2rb98db23eeb",
     "code": "def50200fb4b3a43e7b4d2513ae2db4c14a444cbded99f2fbb29e6f0d3d10bfad6c452548252c01ee4060c2ac6c689dab0d8f37664e682d6e275d5c065dad88c219d2bff4d872f2df440736f0919d1420ad05cecd588749a6a375b51790f706fe16e1685100f433d7fbbe464296dd491f0b767e5c934723162fb58aa22f835a2ed37ca60f8dfec57fce7a4bd5d98e3526610796d4b868586f3672636a53b7df771e9c528c51a11a582c5518f72267f94747b7b9bca367add990847dd0d6a07f97f3377c0f80f97736fffde33fb9124524a81c0d27c6877ac6d03b0d00b46f5758c6ba35baadba3766d01cfac5bb0213dc5115cde5645c9a8f0f385893061ff8247c0d222d7f5941795b8332e17b06c0f34c2744056718954eb3d63a60bc5836909c3b314a8ad8ca16d481b126a1971c552153b25aba5087385a3c42c1b60297ba7d86cd81ceab72bb05fe0f5cb767ceb229a7d239c2c2ae8cda7513b6f7230c2ffbc17a82f53297348399ef29527a2a3b138a1da64eae320e0eedb56e11f9c894f057cfd68fc5b0015b8493bd988a810c7b91836e9539df92398bb0c4de66b749747f09f2240a3d24e27"}