Organizações, aplicações e ambientes

A organização reúne equipa e faturação; as aplicações contêm fluxos de trabalho e chaves de API, e cada uma é live ou sandbox. Perceber isto evita confusões.

#Os dois níveis

Organização é a tua conta. Contém:

• A tua equipa e as suas funções
• O teu saldo de faturação e as faturas
• O teu registo de auditoria
• Todas as tuas aplicações

Aplicação é um espaço de trabalho dentro da organização. Contém:

• Os seus próprios fluxos de trabalho
• As suas próprias chaves de API
• Os seus próprios endpoints de webhook
• A sua própria política de retenção de dados
• Os seus próprios produtos, onde a ativação de produtos por aplicação já foi disponibilizada. Consulta os produtos e o que incluem
• Dois ambientes: Produção e Sandbox

Muda de aplicação a partir do cartão da aplicação no topo da barra lateral. A mudança aplica-se de imediato. O mesmo menu abre Definições da aplicação e Criar aplicação.

#Porque é que isto importa mais do que parece

Quase todos os relatórios do tipo "alterei isto e não aconteceu nada" resolvem-se nesta estrutura:

• Editaste um fluxo de trabalho na aplicação A enquanto as tuas sessões correm na aplicação B.
• Adicionaste um endpoint de webhook a uma aplicação e esperavas eventos de outra.
• Estás a olhar para Sandbox enquanto o teu tráfego corre em Produção, ou o contrário.
• Estás a chamar com uma chave de uma aplicação diferente do recurso a que te estás a dirigir, e a receber um 404 ou 403 para algo que claramente existe.

Antes de depurares qualquer outra coisa, confirma a aplicação. Consulta erros de API e o que significam.

#Produção e Sandbox são ambientes separados

As aplicações novas estão em Produção. Os testes fazem-se em Sandbox: a aplicação de teste partilhada da tua organização, com os seus próprios dados e as suas próprias chaves. Alterna entre elas com o seletor Produção e Sandbox por baixo do nome da aplicação na barra lateral.

As verificações, as chaves de API, os webhooks e as listas são separados em cada ambiente. A marca é partilhada, e os fluxos de trabalho são construídos uma vez e podem ser copiados entre ambientes. Essa separação é o objetivo: o tráfego de teste e os dados de produção nunca se misturam, e uma chave sandbox não consegue gastar créditos reais por acidente. Consulta testar em sandbox.

#Quantas aplicações deves ter?

A maioria das equipas começa com uma, o que já te dá Produção e Sandbox. Além disso, divide por tudo o que precise da sua própria configuração ou do seu próprio isolamento:

• Por produto, quando produtos diferentes precisam de fluxos de trabalho diferentes e de endpoints de webhook diferentes.
• Por ambiente de pré-produção, se precisares de mais do que o único Sandbox.
• Por marca, se ofereceres verificação sob várias marcas com estilos diferentes.
• Por política de retenção, já que a retenção é configurada por aplicação.

O que não se divide por aplicação: o teu saldo, que é ao nível da organização. Todas as aplicações consomem os mesmos créditos.

#Criar aplicações adicionais

Abre o cartão da aplicação no topo da barra lateral e escolhe Criar aplicação, depois introduz um Nome da aplicação (onde os produtos por aplicação já foram disponibilizados, escolhes também para que serve). Se a opção estiver em falta, ou precisares de criar uma através da API em vez da consola, isso é uma questão de permissão ao nível da conta que vale a pena perguntar ao suporte em vez de tentares contornar.

#Várias organizações

Uma pessoa pode pertencer a várias organizações, e alterna entre elas a partir do menu da organização no topo da barra lateral, onde também aparecem os convites pendentes. Criares tu próprio mais do que uma organização está limitado a contas de revendedor (contacta o suporte para o ativar), e não há forma de criar suborganizações ou subcontas sob a tua. Se serves vários clientes teus, a estrutura suportada é uma aplicação por cliente dentro da tua única organização: cada aplicação tem os seus próprios fluxos de trabalho, marca, chaves de API, resultados e relatórios de utilização, totalmente isolados dos restantes, enquanto a faturação fica ao nível da tua organização.

#Revender a Didit

Se queres incluir a Didit no teu próprio produto e cobrá-la aos teus clientes, isso é o modelo de revenda. Como funciona, nos termos que o suporte dá a todos os que perguntam:

• Crédito pré-pago. Uma compra inicial mínima de $5,000 USD, pré-paga, num acordo de um ano. O crédito nunca expira, fica ao nível da tua organização e é consumido por todos os clientes finais que trouxeres, e inclui um desconto por volume que cresce com o montante.
• O painel és tu que o constróis. Integras a API da Didit no teu próprio front-end e os teus clientes gerem aí os seus fluxos de trabalho, marca e funções. A Didit não fornece uma cópia white label da Consola de Negócio; os ecrãs de verificação que os teus utilizadores finais veem podem levar a tua marca (consulta white label), a consola não.
• A tua margem é tua. Defines o preço que os teus clientes pagam. A Didit fatura-te por funcionalidade concluída aos preços unitários fixados pelo prazo do acordo.
• Não é um programa de parceiros locais. A Didit faz demonstrações, integração e suporte diretamente com os clientes e não procura parceiros de distribuição ou implementação.

Se preferires não gerir a revenda, usa antes a opção de recomendação: na Consola de Negócio, abre Definições → Recomende e ganhe, obtém o teu link e partilha-o. Ganhas 10% de comissão sobre cada depósito em dinheiro que uma organização recomendada fizer, durante 36 meses a partir do primeiro depósito dela, utilizável como crédito Didit ou pago por transferência bancária após o período de maturação - sem obrigações de entrega nem de suporte. Podes construir e testar a tua integração no plano gratuito antes de te comprometeres com qualquer uma das opções.

#Eliminar uma aplicação

A eliminação definitiva de uma aplicação ainda não está disponível: Definições da aplicação tem uma Zona de perigo, mas indica que a eliminação está indisponível e não elimina nada. As tuas opções até lá:

• Deixa de a usar. Muda-lhe o nome (algo como acme-old) para que ninguém a escolha por engano, e revoga as suas chaves de API em Programadores → Chaves de API.
• Apaga os dados dos clientes. Os dados de verificação seguem a política de retenção e as regras de eliminação desses dados, e não o ciclo de vida da aplicação - elimina os dados explicitamente. Consulta eliminar sessões e dados pessoais.
• Começa de novo. O suporte pode eliminar a organização inteira para poderes criar uma nova - um último recurso, já que leva consigo a equipa, o saldo e o histórico.

#Tudo é atribuível

Cada alteração regista a que aplicação pertencia, no registo de auditoria. É isso que torna uma estrutura com várias aplicações auditável e não apenas organizada. Consulta usar os registos de auditoria.