Resumo: a tela tem três áreas. Conectores são as integrações nativas de formalização (Clicksign e BNDES Online), cada uma com uma ou mais contas e uma padrão. CRM traz o HubSpot, que transforma negócios do funil em propostas. Conexões de API são os endereços do seu sistema que a etapa Chamada de API chama. Chaves e tokens ficam cifrados e nunca voltam para a tela.
Quem vê o quê
Sem nenhum conector liberado, a área mostra “Nenhum conector contratado”. Veja Módulos e capacidades.
Conectores
Cada conector aparece como um cartão com Conectar (sem conta ainda) ou Gerenciar. Cada conector pode ter várias contas, e a esteira usa a padrão, a menos que a etapa escolha outra.A página do conector
A tabela lista as contas com Conta, Ambiente, Último teste e Situação. A conta padrão leva o selo Padrão.Clicksign
Ao salvar, a plataforma testa a conta e cadastra sozinha o aviso de assinatura na sua Clicksign. É por ele que a esteira fica sabendo quando todas as partes assinaram. Com envelopes em andamento, o token e o ambiente não podem ser trocados. Veja Clicksign.
BNDES Online
Em produção, o BNDES só recebe pedidos em dias úteis, das 8h às 20h. Fora disso, a esteira agenda o envio para a próxima janela. Veja BNDES.
Quando a conta some da etapa
A esteira confere, ao ser ativada, se a conta escolhida em cada etapa ainda existe e está habilitada:- “A conta X escolhida na etapa … não existe mais ou não é desta organização. …”
- ”… está desabilitada. Reative-a em Configurações > Integrações ou escolha outra conta.”
CRM
A área CRM traz o cartão do HubSpot: o negócio que entra num estágio do funil vira proposta, e a decisão volta para o negócio. O cartão mostra a situação da integração (por exemplo, Ativa · sincronizou há 12 min ou Pausada · o HubSpot recusou o token) e o botão Conectar ou Gerenciar. A página do HubSpot tem quatro partes:
O passo a passo, os campos que voltam para o negócio e as mensagens de erro estão em HubSpot.
Conexões de API
Uma conexão de API guarda o endereço e a autenticação de um sistema seu. A etapa Chamada de API escolhe a conexão e define só o caminho, o método, o corpo e as saídas. Não existe conexão padrão: a etapa sempre escolhe.Crie uma conexão
1
Nova conexão de API
Informe Nome da conexão (ex.: “ERP · limites”) e URL base. A URL base é fixa: a esteira só escolhe o caminho depois dela.
2
Autenticação
Escolha o tipo e preencha os campos dele (tabela abaixo). Se precisar, adicione headers fixos.
3
Teste
Em Caminho de teste (GET), informe um caminho que responda, como
/health. Ele é chamado ao salvar para confirmar que a conexão responde. É opcional.4
Testar e criar
A plataforma chama a sua API e salva a conexão.
Por segurança, os segredos guardados não aparecem de novo. Para trocar, digite o novo.
Proteções sempre ligadas
- Só
https://. Chamada sem criptografia não sai da plataforma. - Redirecionamentos são seguidos. Para outro endereço (protocolo, host ou porta diferentes), a autenticação e os headers da conexão não vão junto.
- A resposta pode ter até 2 MB.
- A URL base não leva query nem
#: parâmetros vão na etapa da esteira. - Usuário e senha não vão na URL: use o tipo de autenticação.
A lista de conexões
A tabela mostra Nome, URL base, Autenticação, Último teste e Situação (Conectada, Falha no teste, Não testada ou Desligada), com as ações Testar conexão, Editar e Remover. O que a etapa faz com a resposta (saídas,api.<apelido>, tempo limite, erros) está em Chamada de API.