Skip to main content

​
Administrando Contas

Uma Conta (Account) representa a entidade principal que agrupa seus canais, chaves de API e configurações na plataforma MessageFy. Funciona como um container isolado para cada projeto, departamento ou cliente da sua organization. Antes de criar canais ou enviar mensagens, configure pelo menos uma Account — todos os demais recursos (canais, API Keys, mensagens, métricas) vivem dentro de uma Account específica.
Ao criar uma Account, a plataforma gera automaticamente uma API Key exclusiva com prefixo acc_, já vinculada a essa Account. Use essa chave para autenticar as chamadas seguintes (criação de canais, conexão de sessão, envio de mensagens etc.).

​
Hierarquia

Cada Account é completamente isolada das demais. Credenciais, dados e configurações de uma Account não são visíveis nem manipuláveis a partir de outra.

​
Para que serve uma Account?

Contas foram projetadas para resolver problemas reais de organização e segurança em empresas que operam com múltiplos departamentos, times ou clientes:
Cada departamento tem suas próprias credenciais e não pode acessar recursos de outros. O time de Vendas não tem acesso aos canais do Suporte, e vice-versa.
A abrangência de acesso é definida pelo tipo da API Key, não por permissões individuais: chaves com prefixo acc_ acessam apenas uma Account, enquanto chaves org_ alcançam toda a Organization. O limite de uso de cada chave é controlado pelo seu resourcePlan (rate limit).
Cada Account tem suas próprias métricas. Você pode acompanhar quantas mensagens cada departamento enviou, taxa de entrega, tempo de resposta e demais indicadores de forma isolada.
Em planos enterprise, é possível ter relatórios de uso e custos separados por Account, facilitando chargeback interno ou análise de ROI por departamento.
À medida que sua empresa cresce, novas Accounts são adicionadas sem afetar as existentes. Incluir um novo time ou departamento é simples e não requer reconfiguração dos sistemas já em produção.

​
Casos de uso

​
Caso 1 — E-commerce com múltiplos departamentos

​
Caso 2 — Software house com múltiplos clientes

​
Caso 3 — Empresa com filiais

​
Segurança e isolamento

Cada Account é completamente isolada das demais, garantindo:
  • Isolamento de credenciais — API Keys de uma Account não conseguem acessar recursos de outra. Se uma chave for comprometida, apenas os recursos daquela Account específica ficam em risco.
  • Isolamento de dados — mensagens, estatísticas e logs são separados por Account. O time de Vendas não consegue ver mensagens enviadas pelo time de Suporte.
  • Isolamento de configurações — webhooks, canais e demais configurações são independentes. Alterar um webhook na Account de Marketing não afeta a Account de Vendas.
  • Auditoria granular — todos os logs e ações são registrados no nível da Account, permitindo rastreabilidade completa de quem fez o quê e quando.
Boa prática de segurança: nunca compartilhe API Keys entre Accounts. Cada departamento deve ter suas próprias credenciais — isso facilita a revogação em caso de comprometimento e melhora a auditoria.

​
Operações disponíveis

Listar contas

Consulta todas as Accounts sob a sua gestão, com filtros e paginação.

Buscar por ID

Recupera os detalhes de uma Account específica.

Criar conta

Cria uma nova Account dentro da sua organization.

Atualizar conta

Modifica informações de uma Account existente.

Deletar conta

Remove uma Account que não é mais necessária.

Sobre a chave atual

Endpoint /me que retorna informações sobre a chave de API em uso.
Deletar uma Account também invalida suas API Keys e desativa seus canais. Confirme que não há recursos em uso antes de remover.