{"id":4084,"date":"2024-11-23T04:58:07","date_gmt":"2024-11-23T04:58:07","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/6746045060381\/"},"modified":"2024-12-20T14:46:41","modified_gmt":"2024-12-20T14:46:41","password":"","slug":"6746045060381","status":"publish","type":"docs","link":"https:\/\/alteg.io\/pt\/support\/knowledge-base\/6746045060381\/","title":{"rendered":"Conectando a integra\u00e7\u00e3o por meio do marketplace"},"content":{"rendered":"<h2>Como conectar a integra\u00e7\u00e3o via marketplace:<\/h2>\n<p>1. O usu\u00e1rio deve clicar em <strong>\u201cConectar\u201d<\/strong> na p\u00e1gina do seu aplicativo no marketplace Altegio.<\/p>\n<p>2. A Altegio solicitar\u00e1 uma permiss\u00e3o ao usu\u00e1rio para fornecer acesso \u00e0 sua conta pessoal via API. Depois disso, a integra\u00e7\u00e3o pode ser conectada por uma <strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_settings\" target=\"_blank\" rel=\"noopener noreferrer\">solicita\u00e7\u00e3o de API<\/a><\/strong> (Disponivel em ingl\u00eas) de sua parte.<\/p>\n<p>3. A partir da Altegio, o usu\u00e1rio ser\u00e1 redirecionado para o site do formul\u00e1rio de cadastro em seu servi\u00e7o, que voc\u00ea especificou nas configura\u00e7\u00f5es do aplicativo no campo <strong>\u201cinsira um link para o seu site\u201d.<\/strong><\/p>\n<p><strong>a. <\/strong>O par\u00e2metro <strong>salon_id GE<\/strong>T ser\u00e1 adicionado ao endere\u00e7o url do seu formul\u00e1rio de registro. O valor deste par\u00e2metro <a href=\"https:\/\/support.alteg.io\/hc\/pt-br\/articles\/4904985751069-Como-descobrir-o-seu-n%C3%BAmero-de-localiza%C3%A7%C3%A3o-ID-no-Altegio\" target=\"_blank\" rel=\"noopener noreferrer\">\u00e9 o id da filial da Altegio<\/a>.<br \/><strong>Exemplo:<\/strong> https:\/\/seusite.com\/cadastro?salon_id=12345<\/p>\n<p>4. Ap\u00f3s cadastrar\/autorizar junto ao seu servi\u00e7o, voc\u00ea precisar\u00e1 enviar uma requisi\u00e7\u00e3o de API para conectar a integra\u00e7\u00e3o.<\/p>\n<p><strong>a.<\/strong> Voc\u00ea deve enviar uma solicita\u00e7\u00e3o dentro de <strong>1 hora<\/strong> ap\u00f3s o usu\u00e1rio concordar em fornecer acesso a algumas informa\u00e7\u00f5es da conta pessoal na Altegio (enviada a voc\u00ea na p\u00e1gina de registro). Se a solicita\u00e7\u00e3o for enviada posteriormente, voc\u00ea receber\u00e1 um erro e o usu\u00e1rio precisar\u00e1 reconectar a integra\u00e7\u00e3o pelo marketplace.<\/p>\n<p>Ap\u00f3s o envio do pedido API para conex\u00e3o, a integra\u00e7\u00e3o com o seu servi\u00e7o ser\u00e1 habilitada na conta pessoal da sua filial na Altegio:<\/p>\n<ul>\n<li>O usu\u00e1rio do seu sistema ser\u00e1 adicionado \u00e0 conta pessoal do cliente. Voc\u00ea especifica o ID do usu\u00e1rio do sistema nas configura\u00e7\u00f5es do aplicativo no campo \u201cID do usu\u00e1rio\u201d. Voc\u00ea poder\u00e1 usar o token do portador deste usu\u00e1rio para fazer solicita\u00e7\u00f5es \u00e0 API da filial de acordo com os direitos de acesso solicitados.<\/li>\n<li>Eventos sobre mudan\u00e7as na filial ser\u00e3o enviados para os endere\u00e7os de webhook que voc\u00ea forneceu.<\/li>\n<li>Caso sua integra\u00e7\u00e3o esteja na categoria<strong> Notifica\u00e7\u00f5es<\/strong>, sua <strong>API_KEY<\/strong> tamb\u00e9m ser\u00e1 adicionada \u00e0s configura\u00e7\u00f5es da filial para enviar notifica\u00e7\u00f5es do sistema.<\/li>\n<\/ul>\n<h2>Melhores Pr\u00e1ticas<\/h2>\n<p>Recomenda-se enviar uma solicita\u00e7\u00e3o para conectar a integra\u00e7\u00e3o imediatamente ap\u00f3s a finaliza\u00e7\u00e3o do cadastro do usu\u00e1rio ao lado do seu servi\u00e7o. Depois disso, voc\u00ea ter\u00e1 acesso \u00e0 ramifica\u00e7\u00e3o da API. Em seguida, voc\u00ea pode usar a API para obter os dados necess\u00e1rios sobre a filial, o usu\u00e1rio e facilitar a configura\u00e7\u00e3o da integra\u00e7\u00e3o do seu lado.<\/p>\n<p>Al\u00e9m disso, n\u00e3o se esque\u00e7a de prever que um usu\u00e1rio j\u00e1 cadastrado\/autorizado em seu servi\u00e7o possa vir at\u00e9 voc\u00ea a partir do marletplace Altegio. Envie uma solicita\u00e7\u00e3o para conectar a integra\u00e7\u00e3o no marketplace n\u00e3o apenas no momento do registro, mas quando um usu\u00e1rio fizer login no seu servi\u00e7o ou quando um usu\u00e1rio for do marketplace Altegio diretamente para a conta pessoal em seu servi\u00e7o.<\/p>\n<h2>Por favor, note que<\/h2>\n<h3>Cadastro autom\u00e1tico de usu\u00e1rios em seu sistema<\/h3>\n<p>Para simplificar o processo de conex\u00e3o de sua integra\u00e7\u00e3o, voc\u00ea pode conectar a <strong>transfer\u00eancia de dados do usu\u00e1rio na conex\u00e3o<\/strong>. Neste caso, ao conectar a integra\u00e7\u00e3o, voc\u00ea receber\u00e1 os dados do usu\u00e1rio (nome, telefone, e-mail) e o cadastrar\u00e1 automaticamente em seu sistema sem for\u00e7\u00e1-lo a preencher um formul\u00e1rio. De acordo com nossos dados, usar essa configura\u00e7\u00e3o aumenta a taxa de convers\u00e3o de conex\u00e3o em 30-40%. <a href=\"https:\/\/support.alteg.io\/hc\/en-us\/articles\/6756242694429-Transferring-user-data-when-connecting-the-integration\" target=\"_blank\" rel=\"noopener noreferrer\">Mais.<\/a><\/p>\n<h3>Conectando a integra\u00e7\u00e3o a v\u00e1rias filiais de uma vez<\/h3>\n<p>Se a sua integra\u00e7\u00e3o funciona com v\u00e1rias filiais Altegio, ent\u00e3o conecte a configura\u00e7\u00e3o <strong>\u201cPermitir que o aplicativo seja adicionado a v\u00e1rias filiais\u201d<\/strong>. Nesse caso, ao conectar, o usu\u00e1rio ser\u00e1 solicitado a selecionar em quais filiais deseja instalar a integra\u00e7\u00e3o. <a href=\"https:\/\/support.alteg.io\/hc\/en-us\/articles\/6756399400477-How-to-set-up-an-integration-connection-across-multiple-branches\" target=\"_blank\" rel=\"noopener noreferrer\">Mais<\/a>.<\/p>\n<h3>Conectando e configurando a integra\u00e7\u00e3o do iframe<\/h3>\n<p>Voc\u00ea pode conectar a configura\u00e7\u00e3o <strong>&#8220;Abrir formul\u00e1rio de registro no iframe<\/strong>&#8220;. Ent\u00e3o, ao clicar na p\u00e1gina de cadastro \u201cConectar\u201d do seu servi\u00e7o ela abrir\u00e1 na aba <strong>\u201cConfigura\u00e7\u00f5es\u201d<\/strong> no card do seu aplicativo no marketplace. Isso aumenta significativamente a confian\u00e7a do usu\u00e1rio em seu servi\u00e7o. A intera\u00e7\u00e3o com o seu servi\u00e7o ocorre na interface\u00a0 da Altegio. <a href=\"https:\/\/support.alteg.io\/hc\/en-us\/articles\/6756353811357-How-to-set-up-registration-via-iframe\" target=\"_blank\" rel=\"noopener noreferrer\">Mais.<\/a><\/p>\n<p>\u00a0<\/p>\n<p>\u00a0<\/p>\n<p>\u00a0<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Como conectar a integra\u00e7\u00e3o via marketplace: 1. O usu\u00e1rio deve clicar em \u201cConectar\u201d na p\u00e1gina do seu aplicativo no marketplace Altegio. 2. A Altegio solicitar\u00e1 uma permiss\u00e3o ao usu\u00e1rio para fornecer acesso \u00e0 sua conta pessoal via API. Depois disso, a integra\u00e7\u00e3o pode ser conectada por uma solicita\u00e7\u00e3o de API (Disponivel em ingl\u00eas) de sua&hellip; <a class=\"more-link\" href=\"https:\/\/alteg.io\/pt\/support\/knowledge-base\/6746045060381\/\">Continue reading <span class=\"screen-reader-text\">Conectando a integra\u00e7\u00e3o por meio do marketplace<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[393],"doc_tag":[1258,2077,1273],"class_list":["post-4084","docs","type-docs","status-publish","hentry","doc_category-se-posicionando-no-marketplace-altegio","doc_tag-filial-pt-br","doc_tag-integracoes-pt-br","doc_tag-rede-pt-br","entry"],"aioseo_notices":[],"year_month":"2026-04","word_count":716,"total_views":"98","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"ivan.k","author_nicename":"altegio","author_url":"https:\/\/alteg.io\/pt\/author\/altegio\/"},"doc_category_info":[{"term_name":"Se posicionando no marketplace Altegio","term_url":"https:\/\/alteg.io\/pt\/support\/knowledge-base\/categories\/se-posicionando-no-marketplace-altegio\/"}],"doc_tag_info":[{"term_name":"Filial","term_url":"https:\/\/alteg.io\/pt\/support\/knowledge-base\/docs-tag\/filial-pt-br\/"},{"term_name":"Integra\u00e7\u00f5es","term_url":"https:\/\/alteg.io\/pt\/support\/knowledge-base\/docs-tag\/integracoes-pt-br\/"},{"term_name":"Rede","term_url":"https:\/\/alteg.io\/pt\/support\/knowledge-base\/docs-tag\/rede-pt-br\/"}],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/docs\/4084","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/comments?post=4084"}],"version-history":[{"count":2,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/docs\/4084\/revisions"}],"predecessor-version":[{"id":78147,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/docs\/4084\/revisions\/78147"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/media?parent=4084"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/doc_category?post=4084"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alteg.io\/pt\/support\/wp-json\/wp\/v2\/doc_tag?post=4084"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}