Como Ligar-se

Aceda ao Seu Painel

Visite BOTS4.me/bots

Abrir Definições

Clique em Definições () no topo e depois clique na App que quer configurar

Adicione a Sua Ligação

No Access Manager, clique em «Adicionar Origem» ou «Adicionar Destino» e depois escolha o seu fornecedor

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques, sem necessidade de palavras-passe:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Origem» → selecione Email → escolha Gmail
• A janela de início de sessão da Google abre-se de imediato — inicie sessão com a caixa de correio que pretende ligar
• Autorize na página da Google — pronto! Enquanto a nossa verificação pela Google estiver em curso, a Google pode mostrar «A Google não validou esta app» — escolha Continuar ou Avançadas → Aceder a bots4.me. Se uma autorização da Google alguma vez terminar, um clique em Voltar a ligar em /bots restabelece-a.

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Origem» → selecione Email → escolha o seu fornecedor
• A janela de início de sessão do seu fornecedor abre-se de imediato → inicie sessão e autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Origem» → selecione Email → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect (OAuth)

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Origem» → selecione Email → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth — ou simplesmente utilize a configuração com palavra-passe de aplicação abaixo.

Recomendado: Secure Quick Connect (OAuth)

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Origem» → selecione Email → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth — ou simplesmente utilize a configuração com palavra-passe de aplicação abaixo.

Gerar Palavra-passe Específica para Apps

A Apple exige palavras-passe específicas para apps:

• Aceda a account.apple.com
• Inicie sessão com a sua Conta Apple
• Aceda a «Início de sessão e segurança»
• Clique em «Palavras-passe específicas para apps»
• Clique em «+» para gerar uma nova palavra-passe
• Etiqueta: BOTS4.me
• Copie a palavra-passe apresentada

Obtenha Informação do Departamento de TI

Peça ao seu administrador de TI:

• Os endereços e as portas dos servidores IMAP e SMTP (por exemplo, mail.company.com, 993 / 587)
• Se o IMAP está ativado para a sua caixa de correio
• Se pode iniciar sessão com o seu endereço de e-mail — a BOTS4.me inicia sessão com o endereço de e-mail, não com DOMAIN\utilizador
• Quaisquer requisitos de segurança especiais

O Que Dizer à Sua Equipa de TI

Diga isto ao seu administrador de TI:

Ative o Acesso Externo

Inicie sessão em mail.ru:

• Clique em Definições (ícone de engrenagem)
• Aceda à secção «Clientes de E-mail»
• Ative «Acesso ao Mail.ru via IMAP»
• Guarde as definições

Gerar Palavra-passe de Aplicação

Para maior segurança:

• Aceda às definições da conta
• Procure «Segurança» → «Palavras-passe para aplicações externas»
• Clique em «Adicionar palavra-passe»
• Nome: BOTS4.me
• Copie a palavra-passe gerada

Utilize a Sua Palavra-passe (ou uma Palavra-passe de Aplicação com Início de Sessão em Dois Passos)

• Sem verificação em dois passos: a sua palavra-passe habitual do Seznam funciona para o IMAP
• Com verificação em dois passos: crie uma palavra-passe de aplicação em ucet.seznam.cz → Segurança (Zabezpečení) → Palavras-passe para aplicações (Hesla pro aplikace)
• Dê-lhe o nome BOTS4.me e copie a palavra-passe gerada

Crie a Palavra-passe para Programas de Correio

• Inicie sessão no T-Online E-Mail Center (email.t-online.de)
• Aceda a Menu → Einstellungen (Definições)
• Abra «Passwort für E-Mail-Programme» (palavra-passe para programas de correio)
• Crie a palavra-passe e copie-a

Encontre as Definições do Seu Correio Eletrónico

Pesquise online por: «Definições IMAP de [o seu fornecedor]»

Ou contacte o suporte do seu fornecedor de correio eletrónico para obter:

• O endereço do servidor IMAP (para receber correio)
• A porta IMAP (normalmente 993)
• O endereço do servidor SMTP (para enviar correio)
• A porta SMTP (normalmente 587)
• O tipo de segurança (TLS/SSL ou STARTTLS)

Verifique se Existem Palavras-passe de Aplicação

Muitos fornecedores exigem palavras-passe específicas de aplicação:

• Consulte as definições de segurança da sua conta
• Procure por «palavras-passe de aplicação» ou «application passwords»
• Se disponível, gere uma para a BOTS4.me

Recomendado: BOTS4.me Connector App para Odoo

A forma mais simples de ligar o Odoo — instale o nosso módulo conector diretamente no seu Odoo:

• Instale a BOTS4.me connector app no seu Odoo (loja de Apps)
• Emparelha o seu Odoo com a sua conta BOTS4.me — sem credenciais para copiar manualmente
• Siga passo a passo o Guia de Instalação do Conector do Odoo

Prefere não instalar uma aplicação? Utilize a configuração manual abaixo — funciona com qualquer Odoo 13+.

Utilize um utilizador licenciado do SAP Business One

• Crie um utilizador SAP Business One dedicado ao BOTS4.me (por exemplo B4M_API) — assim os documentos dele são fáceis de reconhecer
• O utilizador precisa de uma licença que permita o acesso ao Service Layer — pergunte ao seu parceiro SAP qual a licença adequada
• O BOTS4.me trabalha com as autorizações deste utilizador: dê-lhe acesso aos documentos das aplicações que utiliza (ver abaixo)

Torne o Service Layer acessível

• O Service Layer corre no seu servidor SAP (normalmente na porta 50000). O BOTS4.me liga-se a ele pela internet, por isso tem de estar acessível a partir de fora da sua rede — normalmente através de um reverse proxy ou do seu parceiro de alojamento
• Só funcionam endereços https. Não é possível usar endereços de rede privada (por exemplo 192.168.x.x ou 10.x.x.x)
• Se a sua firewall só deixa entrar endereços conhecidos, peça a support@bots4.me os endereços dos nossos servidores

Impressão digital do certificado (só quando pedida)

O Service Layer usa muitas vezes um certificado próprio, que o BOTS4.me não consegue verificar. A verificação do painel para então antes de iniciar sessão e mostra a impressão digital SHA-256 do certificado. Compare-a com a impressão digital no seu servidor SAP e, se coincidirem, cole-a em Impressão digital do certificado (SHA-256) no formulário do SAP Business One:

• Windows: abra o endereço do Service Layer no Edge ou no Chrome no servidor SAP, clique no ícone à esquerda do endereço → detalhes do certificado e copie a impressão digital SHA-256 (a caixa de diálogo de certificados do Windows mostra apenas o thumbprint SHA-1 — esse não serve)
• Linux ou macOS: execute este comando no servidor SAP ou na sua rede (substitua your-server):

Quando o certificado é renovado, a impressão digital muda: o BOTS4.me para então antes de iniciar sessão e pede-lhe que confirme a nova.

Pay2ERP: a conta bancária

• O Pay2ERP regista cada pagamento como pagamento recebido no SAP Business One, associado à respetiva fatura, na conta do Razão (G/L) de uma das contas bancárias da sua empresa (house bank)
• Com mais do que uma conta bancária da empresa, abra o cartão do SAP Business One do Pay2ERP e escolha a conta em Conta bancária para pagamentos (a lista aparece após a primeira verificação da ligação)

Vá a /bots → Definições

• Vá a /bots
• Clique em Definições
• Selecione a aplicação que pretende configurar
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta)
• Escolha o mosaico QuickBooks e clique em Iniciar sessão com o QuickBooks

Inicie sessão e escolha a sua empresa

• Inicie sessão com um utilizador administrador da sua empresa no QuickBooks Online
• Se o seu início de sessão tiver várias empresas, o QuickBooks pergunta qual ligar — um início de sessão liga uma empresa
• Clique em Connect. O BOTS4.me lê sozinho o nome, o país e o plano da empresa e mostra-os no cartão do QuickBooks
• Para usar outra empresa, inicie sessão novamente e escolha-a. Ao voltar a ligar um cartão existente, tem de escolher a mesma empresa

Pay2ERP: a conta bancária

• Abra o cartão do QuickBooks do Pay2ERP, escolha a conta bancária em Conta bancária para pagamentos e clique em Guardar alterações
• O Pay2ERP regista cada pagamento no QuickBooks contra a respetiva fatura em aberto e deposita-o nesta conta
• Com exatamente uma conta bancária no QuickBooks, não precisa de a escolher

Recomendado: Secure Quick Connect

Ligue-se com Token-Based Authentication (TBA) — primeiro vai precisar destes dados do NetSuite:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar Destino» → selecione NetSuite
• Introduza o seu Base URL, o Account ID (por exemplo, 1234567), a Consumer Key, o Consumer Secret, o Token ID e o Token Secret
• Clique em «Adicionar ERP» — pronto! Não existe nenhuma página de início de sessão do NetSuite: os tokens dos passos abaixo são a autorização.

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Vá a /bots → Definições

• Vá a /bots
• Clique em Definições
• Selecione a aplicação que pretende configurar
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta)
• Escolha o mosaico Xero e clique em Iniciar sessão com o Xero

Inicie sessão e permita o acesso

• Inicie sessão com as suas credenciais do Xero
• O Xero pergunta que organização o BOTS4.me pode usar — escolha-a e clique em Allow access
• O BOTS4.me lista sozinho as organizações que ligou, com o respetivo país e moeda

Escolha a sua organização (apenas se tiver várias)

• Se ligou mais do que uma organização, abra o cartão do Xero no painel e escolha a organização em que o BOTS4.me deve trabalhar
• Clique em Guardar alterações — as aplicações começam assim que for escolhida uma organização

Pay2ERP: a conta bancária

• Abra o cartão do Xero do Pay2ERP, escolha a conta bancária em Conta bancária para pagamentos e clique em Guardar alterações
• O Pay2ERP regista cada pagamento no Xero contra a respetiva fatura em aberto nesta conta. Reconcilie-o com a linha do extrato bancário no Xero, como habitualmente
• Com exatamente uma conta bancária no Xero, não precisa de a escolher

Recomendado: Secure Quick Connect

Ligue-se de forma segura através de OAuth — primeiro vai precisar de alguns dados:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione Dynamics 365
• Introduza o seu Environment URL (p. ex., https://yourorg.crm.dynamics.com) e o seu Azure Tenant ID
• Clique em «Ligar com OAuth» → autorize na página da Microsoft — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione Salesforce
• Opcionalmente, introduza o seu Salesforce Instance URL (p. ex., https://yourcompany.my.salesforce.com)
• Clique em «Ligar com OAuth» → autorize na página do Salesforce — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Localize o URL da API do Acumatica

• O seu endpoint de API baseia-se na sua instância do Acumatica
• Exemplo: https://yourcompany.acumatica.com/entity/Default/24.200.001
• Consulte o seu administrador do Acumatica em caso de dúvida

Gere uma API Key

• No Acumatica, vá a Configuration → Security → API Keys
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Acumatica
• Cole o seu API URL e a sua API Key
• Clique em Adicionar ERP — está ligado!

Localize o URL da API do Epicor

• O seu endpoint de API baseia-se na sua instância do Epicor
• Exemplo: https://yourcompany.epicorsaas.com/api/v2
• Consulte o seu administrador do Epicor em caso de dúvida

Gere uma API Key

• No Epicor, vá a System Management → API Keys
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Epicor Kinetic
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Localize o URL da API do Freshworks

• O seu endpoint de API baseia-se na sua instância do Freshworks
• Exemplo: https://yourcompany.freshsales.io/api
• Consulte o seu administrador do Freshworks em caso de dúvida

Gere uma API Key

• No Freshworks, vá a Settings → API Settings → Copy your API Key
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Freshworks CRM
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Ligue-se através da sua própria aplicação OAuth

O HubSpot utiliza OAuth — terá de criar uma Developer App gratuita para obter as suas credenciais:

• Crie uma conta gratuita em developers.hubspot.com
• Registe uma nova aplicação e adicione os scopes de CRM necessários
• Obtenha o seu Client ID e o seu Client Secret

Crie uma Developer App do HubSpot

• Vá a developers.hubspot.com → inicie sessão ou crie uma conta gratuita
• Clique em Create App
• No separador Auth, adicione os scopes necessários (CRM objects, contacts, etc.)
• Copie o Client ID e o Client Secret

Introduza as credenciais no BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione HubSpot CRM
• Introduza o seu Client ID e o seu Client Secret

Autorize e ligue-se

• Clique em Connect HubSpot — será redirecionado para o HubSpot
• Selecione a conta do HubSpot que pretende ligar
• Clique em Autorizar — será redirecionado de volta e está pronto!

Localize o URL da API do Infor

• O seu endpoint de API baseia-se na sua instância do Infor CloudSuite
• Exemplo: https://yourcompany.inforcloudsuite.com/api
• Consulte o seu administrador do Infor em caso de dúvida

Gere uma API Key

• No Infor, vá a Administration → Security → API Credentials
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Infor CloudSuite
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Localize o URL da API do Pipedrive

• O seu endpoint de API baseia-se na sua instância do Pipedrive
• Exemplo: https://yourcompany.pipedrive.com/api/v1
• Consulte o seu administrador do Pipedrive em caso de dúvida

Gere uma API Key

• No Pipedrive, vá a Settings → Personal Preferences → API → Copy your API Token
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Pipedrive
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Localize o URL da API do Sage Intacct

• O seu endpoint de API é o URL de Web Services do Sage Intacct
• É fornecido pelo seu administrador do Sage Intacct
• Consulte o seu administrador do Sage Intacct em caso de dúvida

Gere uma API Key

• No Sage Intacct, vá a Company → Admin → Web Services Users
• Crie um utilizador de Web Services e anote o User ID e a palavra-passe
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Sage Intacct
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Recomendado: Secure Quick Connect

Ligue-se de forma segura através de OAuth — vai precisar de alguns dados do seu administrador de SAP:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione SAP S/4HANA
• Introduza o seu Service Layer URL e o nome da Database
• Configure o seu Identity Provider (Microsoft Entra ID, Okta ou Google)
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Localize o URL da API do Workday

• O seu endpoint de API baseia-se no seu tenant do Workday
• Exemplo: https://wd5-services1.myworkday.com/ccx/api/v1/[tenant]
• Consulte o seu administrador do Workday em caso de dúvida

Gere uma API Key

• No Workday, vá a Integration → API Clients → Register an API Client
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Workday
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Localize o URL da API do Zendesk Sell

• O seu endpoint de API é a API do Zendesk Sell (Base)
• Exemplo: https://api.getbase.com/v2
• Consulte o seu administrador do Zendesk em caso de dúvida

Gere uma API Key

• No Zendesk Sell, vá a Settings → OAuth → Personal Access Tokens → Generate Token
• Crie uma nova API key para a integração com o BOTS4.me
• Copie a API Key (e o Secret, se fornecido)

Introduza na BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta) → selecione Zendesk Sell
• Cole o seu API URL e a sua API Key
• Clique em Guardar — está ligado!

Utilize um utilizador com licença do Business Central

• Inicie sessão com uma conta profissional Microsoft que tenha uma licença do Business Central
• O BOTS4.me trabalha com as permissões desse utilizador — atribua-lhe os conjuntos de permissões das aplicações que utiliza (ver abaixo)

Vá a /bots → Definições

• Vá a /bots
• Clique em Definições
• Selecione a aplicação que pretende configurar
• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta)
• Escolha o mosaico Dynamics 365 Business Central e clique em Iniciar sessão com a Microsoft

Se a Microsoft pedir um administrador

• Muitas organizações só permitem que um administrador aprove novas aplicações. A Microsoft indica então que um administrador tem de aprovar o BOTS4.me
• Clique em Pedir ao administrador Microsoft no formulário do Business Central e envie essa ligação ao seu administrador do Microsoft 365 (por exemplo um Global Administrator ou Cloud Application Administrator)
• O administrador abre a ligação, inicia sessão e aceita — uma única aprovação abrange todas as pessoas da sua organização. Depois, inicie sessão novamente no painel

Contabilistas e utilizadores convidados

• Se o seu início de sessão pertencer a outra organização (trabalha no Business Central do seu cliente como convidado ou contabilista), escreva o domínio do seu cliente (por exemplo contoso.com) ou o Tenant ID em Tenant (domínio ou ID) antes de iniciar sessão
• Para a sua própria empresa, deixe este campo vazio

Ambiente e empresa

• O BOTS4.me encontra sozinho os seus ambientes (produção e sandboxes) e as respetivas empresas
• Com exatamente uma empresa, esta é escolhida automaticamente. Caso contrário, abra o cartão do Business Central, escolha o ambiente e a empresa e clique em Guardar alterações — as aplicações começam assim que forem escolhidos
• Se o BOTS4.me não conseguir listar os seus ambientes, escreva o nome do ambiente tal como aparece no endereço web do seu Business Central (por exemplo Production) e inicie sessão novamente

Pay2ERP: a secção do diário de pagamentos

• No Business Central, abra Cash Receipt Journals (diários de recebimentos) e crie uma secção (por exemplo BOTS4ME) cuja conta de contrapartida seja a sua conta bancária
• No cartão do Business Central do Pay2ERP, escolha essa secção em Secção do diário de pagamentos
• O Pay2ERP regista cada pagamento nesta secção, liquidado com a respetiva fatura. Os pagamentos aguardam aí até a secção ser registada — registe-a no Business Central

Vá a /bots → Definições

• Vá a /bots
• Clique em Definições
• Selecione a aplicação que pretende configurar

Adicione a ligação do Zoho

• Clique em Adicionar destino ou Adicionar origem (a aplicação mostra a opção correta)
• Escolha o mosaico Zoho Books / Inventory
• Clique em Ligar Zoho

Ligar com OAuth

• A janela de início de sessão do Zoho abre-se de imediato
• Inicie sessão com as suas credenciais do Zoho
• Clique em Aceitar para conceder o acesso
• O BOTS4.me encontra sozinho o seu centro de dados Zoho e a sua organização

Escolha a sua organização (apenas se tiver várias)

• Se o seu início de sessão Zoho tiver mais do que uma organização, abra o cartão Zoho no painel e escolha a organização em que o BOTS4.me deve trabalhar
• Clique em Guardar organização — as aplicações iniciam assim que for escolhida uma organização

Crie um utilizador de integração (recomendado)

• No ERPNext, vá a Users → crie o utilizador "BOTS4.me Integration"
• Atribua-lhe estes papéis: Sales User, Purchase User, Stock User, Accounts User, Sales Master Manager e Purchase Master Manager (sem os dois papéis Master Manager, o ERPNext oculta os preços à API)

Gere a API Key & Secret

• Abra o utilizador → separador Settings → API Access
• Clique em "Generate Keys"
• Copie o API Secret apresentado uma única vez e a API Key do campo

Ative a API REST

• No Dolibarr, vá a Home → Setup → Modules/Applications
• Ative API REST (server) (no grupo "Multi-modules tools" ou "Interfaces with external systems")

Crie um utilizador de integração (recomendado)

• Vá a Users & Groups → crie o utilizador "BOTS4.me Integration"
• No separador Permissions, atribua-lhe as permissões das aplicações que utiliza: Mail2ERP — terceiros, produtos, propostas comerciais, encomendas de clientes; Supplier2ERP e AutoPURCHASE — encomendas a fornecedores (ler, criar, validar, aprovar, encomendar); Pay2ERP e AutoCASH — faturas de clientes, pagamentos, bancos; AutoERP — encomendas de clientes, envios, faturas de clientes, stock; AutoSTOCK — stock, produtos
• Todas as aplicações precisam também de: Banks — ler (a sua moeda e o seu país) e Users — ler a própria ficha de utilizador
• Tornar o utilizador administrador é opcional: apenas permite que o AutoERP crie sozinho o seu campo de encomenda (ver passo 4)

Gere a API Key

• Abra a ficha do utilizador → Modify → campo API key → clique no ícone de gerar → Save
• Copie a chave — o BOTS4.me volta a pedi-la sempre que alterar esta ligação

Apenas AutoERP: o campo de encomenda "BOTS4.me tags"

O Dolibarr não permite que outros programas leiam as etiquetas de uma encomenda de cliente, por isso o AutoERP usa em alternativa um campo da encomenda. Quando o utilizador de integração é administrador, o AutoERP adiciona-o sozinho. Caso contrário, adicione-o uma vez manualmente:

• Setup → Modules → Sales Orders (ícone de engrenagem) → Complementary attributes → New attribute
• Etiqueta BOTS4.me tags, código do atributo b4mtags, tipo String (1 line), comprimento 255, "Always editable" ativado
• Para enviar uma encomenda através do AutoERP, escreva a etiqueta AutoERP (por exemplo AutoERP) neste campo da encomenda — o AutoERP acrescenta as suas próprias etiquetas de progresso ao mesmo campo

Crie um utilizador de integração (recomendado)

• Admin → User Management → crie o utilizador "BOTS4.me Integration"
• Conceda-lhe acesso aos módulos de que o seu fluxo de trabalho necessita (Accounts, Contacts, Opportunities, Quotes)

Registe a plataforma de API (se necessário)

As versões mais recentes do SugarCRM só aceitam inícios de sessão de API a partir de plataformas registadas:

• Admin → Configure API Platforms
• Adicione o identificador de plataforma: t_integration

Crie um Self Client

• Vá a api-console.zoho.com (inicie sessão com a conta de administrador do CRM)
• Clique em "Add Client" → escolha Self Client
• Copie o Client ID e o Client Secret

Gere um Refresh Token

• No Self Client, abra "Generate Code"
• Scope: ZohoCRM.modules.ALL,ZohoCRM.settings.READ — duração de 10 minutos
• Troque o código por um refresh token (o nosso formulário de configuração faz isto por si quando cola o código)

Recolha a informação da API

Vai precisar que o seu fornecedor de API lhe disponibilize:

• API Endpoint URL - o URL base da API
• Authentication Type - Bearer Token, API Key, Basic Auth ou OAuth2
• Credentials - consoante o tipo de autenticação

Opções de autenticação

O BOTS4.me suporta vários tipos de autenticação:

• Bearer Token: um único token para autenticação
• API Key: chave e secret opcional
• Basic Auth: nome de utilizador e palavra-passe
• OAuth 2.0: Client ID e secret

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em «Adicionar destino» → selecione CLOUD → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione Armazenamento na nuvem → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione Armazenamento na nuvem → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Recomendado: Secure Quick Connect

A forma mais rápida de se ligar — apenas alguns cliques:

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar destino" → selecione Armazenamento na nuvem → escolha o seu fornecedor
• Clique em «Ligar» → autorize — pronto!

Se o Secure Quick Connect ainda não estiver disponível, verá opções para o solicitar ou para se ligar com a sua própria aplicação OAuth.

Crie um utilizador IAM

• Vá à AWS Console → IAM
• Users → «Create user»
• Nome de utilizador: bots4me
• Depois de criar o utilizador: Security credentials → Create access key

Configure as permissões

• Associe a política: AmazonS3FullAccess (ou crie uma personalizada)
• Continue até criar o utilizador

Guarde as chaves de acesso

⚠️ Guarde ambas - não voltará a ver a chave secreta!

Crie uma conta de armazenamento

• Vá a: portal.azure.com
• Create resource → "Storage account"
• Preencha os dados → Create

Obtenha a Connection String

• Vá à sua Storage Account
• Menu esquerdo: Access keys
• Copie a Connection string

Crie as Access Keys

• Inicie sessão na Wasabi Console
• Vá a Access Keys
• Clique em Create New Access Key
• Copie a Access Key e a Secret Key

Configure no BOTS4.me

• Vá a /bots → Definições
• Clique em «Adicionar destino» → CLOUD
• Selecione Wasabi
• Introduza a sua Access Key e a sua Secret Key
• Selecione a sua região do Wasabi
• Especifique o nome do bucket

Crie uma Application Key

• Inicie sessão no Backblaze B2
• Vá a App Keys
• Clique em Add a New Application Key
• Nome: BOTS4.me
• Copie keyID e applicationKey

Configure no BOTS4.me

• Vá a /bots → Definições
• Adicione a ligação de armazenamento na nuvem
• Selecione Backblaze B2
• Introduza o seu Key ID e a sua Application Key
• Especifique o nome do bucket

Obtenha os dados do servidor WebDAV

• URL de WebDAV (p. ex., https://webdav.example.com)
• Nome de utilizador e palavra-passe
• Caminho do diretório de destino

Configure no BOTS4.me

• Vá a /bots → Definições
• Adicione a ligação de armazenamento na nuvem
• Selecione WebDAV
• Introduza o URL do servidor, o nome de utilizador e a palavra-passe
• Especifique o diretório remoto

Obtenha o seu URL de webhook

O BOTS4.me irá fornecer-lhe um URL de webhook único

Configure-o no seu sistema

• Adicione o URL de webhook no seu sistema de origem
• Selecione os eventos que ativarão os webhooks
• Teste a ligação

Crie um Zap

• Inicie sessão em zapier.com
• Clique em "Create Zap"
• Escolha a sua aplicação de ativação

Adicione a ação do BOTS4.me

• Procure por "Webhooks by Zapier"
• Utilize o URL de webhook fornecido pelo BOTS4.me
• Associe os seus campos de dados

Crie um cenário

• Vá a make.com
• Crie um novo cenário
• Adicione o seu módulo de ativação

Adicione o módulo HTTP

• Adicione "HTTP" → "Make a request"
• Introduza o URL de webhook do BOTS4.me
• Configure a associação de dados

Vá a /bots → Definições

• Vá a /bots
• Clique em Definições
• Selecione a aplicação que pretende configurar

Adicione a ligação do n8n

• Clique em Adicionar integração
• Selecione n8n na lista pendente
• Escolha o método de ligação OAuth

Ligar com OAuth

• Clique no botão Ligar com o n8n
• Será redirecionado para o início de sessão do n8n cloud
• Inicie sessão com a sua conta n8n
• Clique em Autorizar para conceder o acesso

Pronto!

• Será redirecionado de volta para o BOTS4.me
• O seu n8n está agora ligado de forma segura
• Comece a criar fluxos de trabalho automatizados!

Crie o acesso à API no Revolut Business

• Inicie sessão em business.revolut.com (conta de administrador/proprietário)
• Vá a Settings → APIs → Business API
• Crie o acesso à API e copie a API key

Adicione a ligação no BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar origem" → selecione API → escolha Revolut Business
• Cole a chave de API e guarde — pronto!

Crie um token de API no Wise

• Inicie sessão em wise.com com a sua conta Business
• Vá a Settings → API tokens (Integrations and Tools)
• Clique em "Create token" → escolha Read only
• Dê-lhe o nome BOTS4.me e copie o token

Adicione a ligação no BOTS4.me

• Aceda a /bots → Definições → clique na sua App
• Clique em "Adicionar origem" → selecione API → escolha Wise
• Cole o token de API e guarde — pronto!

Mais fácil: instale o plugin gratuito B4M_AutoGEO

• Descarregue o plugin a partir do seu painel em /bots e carregue-o em Plugins → Adicionar novo plugin → Carregar plugin; depois clique em Ativar
• Abra o menu BOTS4.me → AutoGEO no wp-admin e inicie sessão com a sua conta BOTS4.me
• Clique em Ligar — o plugin cria ele próprio a palavra-passe de aplicação e regista o seu site. Concluído!

Ou à mão: crie uma palavra-passe de aplicação

• No WordPress, vá a Utilizadores → Perfil (com sessão iniciada como administrador)
• Desça até Palavras-passe de aplicação, introduza o nome BOTS4.me AutoGEO e clique em "Adicionar nova palavra-passe de aplicação"
• Copie a palavra-passe de imediato — o WordPress só a mostra uma vez

Adicione a ligação no BOTS4.me

• Aceda a /bots → Definições → clique em AutoGEO
• Clique em "Adicionar origem" → selecione API → escolha WordPress
• Introduza o URL do seu site (https://…), o seu nome de utilizador WordPress e a palavra-passe de aplicação e guarde — o AutoGEO testa a ligação de imediato