Pastas de soluções
Uma pasta agrupa soluções relacionadas. Toda solução pertence a pelo menos uma pasta, e a pasta oferece três coisas além da organização: memória compartilhada, uma API key única e um endpoint de integração que atende todas as soluções membro.
Abra a pasta pelo ícone de configurações ao lado dela na barra lateral, ou por Configurar Pasta na lista de soluções.
Nome, slug e o estado Ativo. Uma pasta inativa desaparece da barra lateral e para de atender chamadas no seu endpoint.
Soluções
Seção intitulada “Soluções”
A aba tem duas listas:
- Soluções nesta pasta — as soluções membro, com nome, slug, modo, status e data de entrada.
- Soluções disponíveis — as demais, com o botão Adicionar.
Integração
Seção intitulada “Integração”
Aqui a pasta ganha um ponto de entrada único para sistemas externos:
| Elemento | O que é |
|---|---|
| Endpoint de API de Entrada | O endereço que o sistema externo chama, com o botão Copiar URL |
| Gerenciamento de API Key | Criar chave gera a chave da pasta — ela é exibida apenas uma vez |
| Exemplo de Uso | Um exemplo pronto de requisição, com headers e corpo |
O corpo da requisição traz um campo solutionKey, e é ele que decide qual solução da pasta vai
atender a mensagem. Ou seja: um endereço e uma chave só, com roteamento por solução.
Memória
Seção intitulada “Memória”
Memórias criadas aqui ficam disponíveis para todas as soluções e agentes da pasta. É o lugar certo para conhecimento comum a várias soluções — a política de trocas da empresa, por exemplo, usada tanto pelo atendimento quanto pelo pós-venda.
Nas soluções membro, essas memórias aparecem marcadas como Herdada. Veja Memória para os tipos, alcances e permissões.
Quando criar uma pasta nova
Seção intitulada “Quando criar uma pasta nova”- Quando várias soluções compartilham conhecimento e faz sentido mantê-lo em um só lugar.
- Quando um sistema externo precisa falar com várias soluções sem gerenciar uma chave para cada uma.
- Quando a lista de soluções cresceu a ponto de atrapalhar a navegação.