Equipes e projetos

O Console chama uma organização de equipe. Uma equipe é dona dos seus membros, da cobrança, das chaves de equipe, dos projetos e do histórico de auditoria da equipe. Um projeto agrupa sessões, tokens de projeto, webhooks, modelos, campanhas e configurações de integração.

​

Funções

As funções na equipe são:

• Proprietário: gerencia a equipe e pode executar ações restritas a proprietários.
• Administrador: pode gerenciar membros e os recursos de projeto permitidos a administradores.
• Membro: pode usar os recursos permitidos pela participação atual e pela política do projeto.

Os convites podem atribuir admin ou member. Propriedade não é uma função de convite. Toda equipe pode ter qualquer número de membros. A autorização é verificada com base na participação atual, então uma mudança de função ou de participação pode afetar a próxima solicitação.

​

Convites da conta

Abra Conta > Convites para revisar os convites pendentes enviados ao e-mail verificado da sua conta. Aceitar um convite adiciona você à equipe e só abre o Console depois de atualizar o seu acesso de membro. Recusar remove o convite da sua lista. Se a sua sessão do Console expirar com esta página aberta, entre de novo e o Console leva você de volta a Convites. Quando não há convites pendentes, a página mostra um estado vazio. Peça a um proprietário ou administrador da equipe que envie outro convite se um convite esperado tiver expirado ou não aparecer mais. Você não precisa ter sua própria equipe para aceitar um convite. Se você tiver convites pendentes ao abrir o Console pela primeira vez, ele lista esses convites antes da criação da equipe. Selecione Entrar na equipe para participar ou Criar minha própria equipe.

​

Fale com o suporte

Use o balão de chat no canto inferior direito de qualquer página do Console para falar com o suporte. O chat aceita anexos e mantém a conversa vinculada à sua conta quando você navega ou recarrega a página. A linha do código de suporte na barra lateral, acima de Documentação, copia o código da equipe ativa, ou o seu código pessoal enquanto você está em Conta. Você também pode escrever para support@polymorfa.com com texto ou anexos. Selecione uma equipe durante o onboarding para torná-la a equipe ativa. O onboarding está disponível em inglês e em português do Brasil; escolher um idioma atualiza as etapas restantes e salva o idioma na sua conta para todo o Console. Consulte Idioma. O onboarding salva o seu progresso na equipe ativa conforme você avança. Se não for possível salvar uma etapa, permaneça nela e tente novamente. Reabrir uma equipe com a configuração inacabada retoma a configuração salva. Depois que você dá nome a uma nova equipe, o onboarding mostra o modo de cobrança dela: Free ou Pay-As-You-Go, com o que cada um inclui. O onboarding não pede que você escolha nem pague um plano. A última etapa mostra de novo o modo de cobrança da equipe. Uma equipe Free pode abrir o projeto ou selecionar Mudar para Pay-As-You-Go para abrir a lista de mudança de plano. Toda equipe pode convidar qualquer número de membros; consulte Equipes Free e Pay-As-You-Go.

​

Configurações da conta pessoal

Abra Conta > Configurações para gerenciar as orientações e a sua conta pessoal. Em Nome de exibição, envie uma foto de perfil JPG, PNG ou WebP de até 2 MB e edite o nome que seus colegas veem. A foto salva também aparece no menu da conta do Console. Selecione Remover para voltar à foto gerada ou à foto da conta conectada. Em Idioma, escolha Automático, English ou Português (Brasil) para o Console. Consulte Idioma. Selecione Redefinir dicas para mostrar de novo as orientações do Console que você dispensou. Redefinir as dicas não reinicia a configuração da equipe nem altera os dados da equipe. Para excluir a sua conta pessoal de forma permanente, selecione Excluir conta e digite o e-mail com que você entrou, exatamente como aparece. A exclusão remove a sua conta pessoal e as suas participações em equipes. Os recursos de uma equipe continuam com essa equipe. Se você for o único proprietário de uma equipe, defina outro proprietário ou exclua a equipe antes de excluir a sua conta. Você precisa ter entrado nas últimas 24 horas; caso contrário, saia e entre de novo primeiro. A exclusão da conta pessoal não pode ser desfeita.

​

Visão geral dos projetos

A visão geral da equipe mostra Uso e Cobrança na coluna principal, Projetos no centro e Análises/logs em outra coluna. Busque projetos pelo nome. Escolha Galeria ou Tabela. Cada cartão de projeto mostra o progresso da conexão e do limite de gastos, os totais de mensagens e a última atividade. Selecione o nome de um projeto para abrir Comece aqui, ou selecione Novo para criar um projeto. No Pay-As-You-Go, proprietários e administradores da equipe veem em Cobrança o saldo de créditos, o progresso do bônus, os detalhes da recarga automática ou programada, o custo de hoje, os gastos mensais e o gráfico de gastos diários. O orçamento mensal de cada projeto aparece no cartão dele. Equipes Free mostram as franquias, um selo de cobrança Free e um link de mudança de plano para proprietários e administradores; elas não solicitam dados de gastos pagos nem mostram orçamentos pagos. Análises mostra leituras, respostas, tempos de resposta, conversas aguardando resposta e resultados de chamadas das últimas 24 horas, depois da adesão. Ver todos abre a página completa de Análises. Medições ausentes continuam desconhecidas. Os logs recentes continuam disponíveis independentemente de Análises. A visão geral do projeto limita os dois resumos ao projeto selecionado. Gerenciar limites abre os controles em Uso. Os limites e a prioridade dos projetos são gerenciados ali; números e clientes usam os próprios painéis de detalhes. A ação Orçamento no menu da linha de um número real abre o controle dele diretamente. Consulte orçamentos de gastos. O banner no canto superior esquerdo da barra lateral mostra o modo de cobrança da equipe, Free ou Pay-As-You-Go. Abra Cobrança para mudar o plano de uma equipe Free. Saúde mostra a quantidade de números conectados em relação ao total, como 1 / 2 conectados. O ícone diferencia todos conectados, parcialmente conectados, nenhum conectado e sem números. Isso indica a cobertura de números, não um estado de conexão do próprio projeto. Abra Números para ver o estado de conexão de cada número e os motivos. Um projeto selecionado tem as abas Comece aqui, Visão geral, Atividade e Configurações, além de Financiamento para proprietários e administradores no Pay-As-You-Go. Cada aba tem uma URL compartilhável. Abrir um projeto sem um link de aba sempre seleciona Comece aqui, mesmo depois que a lista de verificação estiver concluída. O cabeçalho do projeto mantém Números, Uso, Configurações do projeto, o botão de copiar o ID do projeto e as ações de API disponíveis acima das abas. Use o seletor de projetos no topo para trocar de projeto. Visão geral mostra a cobertura de conexão, os totais de mensagens e Análises. Atividade mostra logs recentes, resultados de campanhas, contagens de aprovação de modelos e contagens de fluxos e telas. Comece aqui contém a lista de verificação do projeto. Financiamento mostra o orçamento do projeto; edite limites e prioridade em Uso. Configurações contém o nome, o ícone e os padrões de plano de número do projeto para proprietários e administradores, além de links para chaves de API, webhooks, Drains e configurações do QuickLink. Quando os dados não estão disponíveis, as seções mostram o carregamento ou a opção de tentar novamente, em vez de exibir uma contagem zero. A visão geral rotula o ID do projeto e oferece um botão de copiar. Esse é o ID usado pelas integrações, não o slug da URL do projeto. Selecione o ícone ou o nome do projeto para abrir Configurações do projeto. Proprietários e administradores podem salvar um novo nome, ícone ou plano de número padrão sem mudar o ID nem a URL do projeto.

​

Padrões de plano de número

Plano padrão dos números se aplica aos números que não têm uma substituição individual de plano. Alterar esse plano muda o plano efetivo desses números; as substituições existentes não mudam. Standard e Pro descrevem planos de número, não assinaturas de projeto. O modo de cobrança e os adicionais da equipe são gerenciados em Cobrança.

​

Crie um projeto

Abra Projetos e selecione Novo. O mesmo processo de criação abre a partir do seletor de projetos e da página Projetos vazia.

1. Digite um nome para o projeto e escolha o ícone dele.
2. Em uma equipe Free, escolha Continuar no Free ou Mudar para Pay-As-You-Go e depois selecione o plano de número padrão. Equipes Pay-As-You-Go selecionam apenas o plano de número padrão.
3. Revise o projeto e selecione Criar projeto.

Escolher Mudar para Pay-As-You-Go não muda o plano da equipe por si só. Essa opção abre a lista de mudança de plano depois que o projeto é criado. Escolher Continuar no Free abre o novo projeto para que você conecte números de teste e valide a integração. Se nenhum plano de número ativo estiver disponível, você não pode criar um projeto até os preços carregarem. Uma equipe Free pode ter um projeto. Quando uma equipe Free já tem um projeto, Novo mostra um aviso de mudança de plano em vez das etapas de criação. A API retorna 409 com o código de erro payg_required para a mesma solicitação.

​

Equipes Free e Pay-As-You-Go

Toda equipe usa um destes dois modos de cobrança: Novas equipes começam no Free. Projetos Free não expiram. A criação de equipes também tem limite. Enquanto você não for proprietário de uma equipe Pay-As-You-Go, só pode criar uma equipe se não pertencer a nenhuma equipe. Depois que você cria uma equipe ou entra em uma, criar outra exige uma equipe Pay-As-You-Go da qual você seja proprietário. Convites não têm limite: você pode aceitá-los a qualquer momento. Quando o limite se aplica, os proprietários de equipe veem Mude de plano para criar equipes no seletor de equipes, e a criação de equipe mostra um aviso de mudança de plano. Em uma equipe Free, você ainda pode vincular um número real no Console com Vincular um número real agora e enviar QuickLinks para números de teste. Quando uma equipe Free atinge um limite, o Console mostra um aviso de mudança de plano no ponto em que o limite se aplica: ao criar um segundo projeto, ao adicionar um número real além da franquia da equipe ou ao enviar um QuickLink para um número real. A API retorna 409 com o código de erro payg_required para essas solicitações. O período de teste de lançamento oferecido anteriormente em setembro de 2026 foi substituído pelo crédito da semana de lançamento, que uma equipe recebe quando muda para o Pay-As-You-Go.

​

Mudar para Pay-As-You-Go

Proprietários e administradores mudam o plano de uma equipe pela lista de mudança de plano. A equipe salva os dados da empresa, o perfil de tráfego e o consentimento de marketing, quando aplicável, e depois confirma um cartão com uma verificação de US$0 ou compra um pacote regular no cartão a partir de US$10, R$50 ou ₹1.000, antes de impostos e descontos autorizados. As formas Pix (Brasil) ou UPI (Índia), quando disponíveis, usam uma compra inicial de créditos. Com Recarga manual, Pix e UPI exigem uma recarga inicial que adiciona 100 créditos. Com Programada, o primeiro pacote programado e a configuração da autorização recorrente usam um único checkout, sem compra mínima separada. A mudança de plano vale para toda a equipe e não pode ser desfeita. Todo aviso de mudança de plano no Console, incluindo o cartão de mudança de plano em Cobrança, abre a lista de mudança de plano. Depois da mudança de plano:

• Todo número real, incluindo o que era gratuito, usa créditos a partir da próxima janela de cobrança.
• Você pode criar mais projetos e enviar QuickLinks para números reais.
• Os números de teste continuam gratuitos.

​

Leve um projeto para produção

Selecione Mudar para Pay-As-You-Go na visão geral de um projeto, ou escolha essa opção ao criar um projeto, para abrir a lista de mudança de plano. Ela mostra todas as etapas em uma coluna:

1. Dados da empresa: o nome público da empresa, o site HTTPS, o e-mail de suporte, o país de origem, o tipo de empresa, a razão social ou nome completo e a identificação fiscal (CPF ou CNPJ no Brasil, opcional nos demais países).
2. Tráfego e consentimento: os tipos de mensagem, o volume mensal esperado, a descrição da autorização de contato (opt-in) e a confirmação do consentimento. Adicione capturas de tela opcionais de opt-in e opt-out nos cartões de envio.
3. Pagamento e recarga: escolha Cartão de débito/crédito, Pix (Brasil) ou UPI (Índia) e depois escolha Por previsão, Programada ou Recarga manual entre as opções disponíveis para essa forma de pagamento. Configure a recarga ou a programação nesta etapa, ou escolha um pacote inicial avulso.

Depois da confirmação do pagamento, selecione Concluir ou Pular por enquanto. Você pode alterar as configurações de recarga e comprar créditos depois, em Cobrança. Selecione Continuar para ir à próxima etapa e Voltar para retornar à anterior. Selecione qualquer etapa que você já alcançou para reabri-la e alterá-la; depois que os dados forem salvos, continuar a partir de uma etapa alterada salva essa etapa de novo. Os dados que sua equipe salvou antes já vêm preenchidos, e a lista abre em Pagamento e recarga, ou em Dados da empresa quando faltam o país, o tipo de empresa, a razão social ou a identificação fiscal. As respostas de empresa e de consentimento já concluídas são reaproveitadas. Se o pagamento pedir um Endereço de cobrança, preencha apenas o endereço da fatura, a cidade, o CEP e o país que estiverem faltando e salve. O e-mail de suporte da empresa é separado do e-mail de cobrança que recebe as faturas. Mudar o e-mail de cobrança não muda a identidade verificada que você usa para entrar. Impostos e o IOF do Pix, informado separadamente, não adicionam créditos. Se você voltar de um app do banco ou a página recarregar, revise Pagamentos pendentes e selecione Continuar pagamento para a compra existente. Um resultado do formulário de pagamento ou da autenticação do banco, sozinho, não confirma a mudança de plano da equipe. Quando a mudança de plano é confirmada, a lista inicia uma inscrição em produção assíncrona para o projeto. A inscrição em produção exige o Pay-As-You-Go: a solicitação de uma equipe Free retorna 409 com o código de erro payg_required. A resposta inclui operationId; leia GET /platform/operations/{operationId} até que o status seja succeeded, failed, cancelled ou action_required. Se o status for action_required, use o endpoint de aprovação depois de resolver o requisito informado. Você pode cancelar uma inscrição ativa; o cancelamento remove os recursos provisionados antes que a operação chegue a cancelled. Use projetos separados quando precisar de sessões, credenciais de projeto, webhooks ou configurações de integração isolados. Um token de projeto fica vinculado a um único projeto e não autoriza o acesso aos recursos de outro projeto.

​

Configurações pessoais de notificação

Abra o sino de notificações na barra lateral para ver a sua Caixa de entrada e o seu Arquivo. Role dentro de qualquer uma das listas para ver mais notificações. Selecione Configurações no painel para abrir Minhas notificações da equipe selecionada. Marcar todas como lidas limpa os indicadores de não lidas; Arquivar todas move as notificações da caixa de entrada para o arquivo. Espere uma ação terminar antes de iniciar outra. Se uma ação falhar, aparece uma notificação de erro para que você tente novamente. Use o botão de fechar de um aviso para dispensá-lo. Quando vários avisos estiverem abertos, selecione Dispensar todos para fechar todos. Abra Configurações da equipe > Minhas notificações para escolher como a atividade da equipe ativa chega até você. As notificações no app continuam ativadas. Para e-mail, selecione uma caixa de entrada verificada padrão, escolha os tipos de notificação que enviam e-mail e adicione uma rota personalizada para qualquer projeto que precise de outra caixa de entrada. As alterações são salvas à medida que você as faz e valem apenas para a sua participação nessa equipe. Gerencie os seus endereços verificados em Configurações da conta. O roteamento por projeto está disponível apenas para projetos da equipe ativa. Ative Alertas de saldo para receber alertas por e-mail de toda a equipe um dia e duas horas antes da falta de créditos prevista. A página de Cobrança mostra a previsão e os controles de recarga automática. Bônus mensal desbloqueado envia um e-mail quando a equipe alcança uma faixa mais alta de bônus mensal; essa opção vem ativada por padrão. Os interruptores de e-mail são agrupados pelo que os dispara. Os e-mails de convite e de verificação são obrigatórios e não têm interruptor para desativar: Novo acesso à conta pertence à sua conta, não a uma equipe. Alterar essa opção na página de qualquer equipe altera a opção em todas as equipes. Os avisos de entrada de membros chegam aos membros da equipe. Os avisos de mudança de função chegam ao membro cuja função mudou. Os avisos de falha e de conclusão de campanha se referem ao estado final de uma campanha; pausar uma campanha não gera nenhum dos dois avisos. As falhas de deploy de Function se referem a builds de Function com falha. Esses alertas não dão acesso a Functions. Primeiro uso de chave de API informa o primeiro uso verificado de uma chave de equipe ou de projeto recém-emitida. Chaves emitidas antes da criação desse alerta não geram um aviso histórico de primeiro uso. Uma credencial verificada não prova que a solicitação foi concluída com sucesso. Para desativar o e-mail de primeiro uso, abra Minhas notificações e desative Primeiro uso de chave de API. Este e-mail de segurança leva às configurações de notificação e não tem link de cancelamento com um clique. Os avisos de manutenção programada incluem a janela de manutenção anunciada. Um aviso que não for enviado antes do fim dessa janela não é enviado por e-mail depois.

​

Cancele um e-mail de notificação

Os e-mails de notificação opcionais, exceto os de primeiro uso de chave de API, terminam com um link Unsubscribe from these emails. Abrir o link mostra a qual tipo de notificação e a qual equipe ele se aplica; nada muda até você selecionar Desativar estes e-mails. Depois disso, o e-mail desse tipo deixa de chegar apenas para essa equipe. As notificações no app e as suas outras escolhas de e-mail continuam como estão. Apps de e-mail que oferecem o próprio botão de cancelar inscrição enviam a mesma solicitação. Para voltar a receber esses e-mails, reative o tipo em Minhas notificações. Códigos de acesso, convites, códigos de exclusão e alertas de segurança não têm link de cancelamento. Um link de cancelamento expira um ano depois do envio do e-mail e para de funcionar se você sair da equipe.

​

Exclua uma equipe

Somente um proprietário da equipe pode excluí-la. A sua conta precisa pertencer a pelo menos uma outra equipe antes que você possa excluir uma equipe. Qualquer proprietário pode cancelar a exclusão em até 24 horas após a confirmação. A exclusão começa depois desse prazo, quando nada a impedir, incluindo um pagamento ainda em processamento. Abra Configurações da equipe, selecione Geral e depois Excluir equipe. Você também pode selecionar Excluir equipe no menu de uma equipe em Configurações da conta > Equipes. Antes da confirmação, o Console mostra:

• todos os números que a equipe ainda tem, com o projeto de cada um
• o saldo de créditos restante da equipe, que é perdido quando a equipe é excluída. Os créditos não são reembolsados nem transferidos para outra equipe.
• tudo o que precisa ser resolvido antes, como uma assinatura ativa ou um pagamento ainda em processamento

Para agendar a exclusão:

1. Digite o nome da equipe exatamente como aparece.
2. Selecione Enviar código por e-mail e digite o código de seis dígitos enviado ao e-mail da sua conta. Se a autenticação de dois fatores por app autenticador estiver ativada na sua conta, digite também um código atual do app autenticador.
3. Selecione Agendar exclusão em até 5 minutos depois de confirmar a sua identidade.

Cada confirmação autoriza uma única solicitação, apenas para essa equipe. Se ela expirar ou uma solicitação for recusada, confirme a sua identidade de novo. Você pode pedir até cinco códigos em 15 minutos, e um código para de funcionar depois de cinco tentativas incorretas. Todos os proprietários da equipe recebem um e-mail com o prazo para cancelamento e um lembrete cerca de 2 horas antes dele.

​

Enquanto a exclusão está agendada

A equipe continua visível para os membros, com um banner que mostra o prazo para cancelamento. A equipe fica somente leitura:

• Solicitações que alteram a equipe, como enviar mensagens, criar chaves de API, iniciar campanhas ou comprar créditos, retornam 409 com o código de erro team_deletion_scheduled. Isso vale para chaves de API, tokens de projeto e o Console. A leitura de dados continua funcionando.
• Campanhas em execução param de enviar e mantêm o progresso.
• As recargas automáticas não são executadas.
• Os números continuam conectados e recebendo mensagens, e os webhooks continuam entregando eventos. Você não precisa parear os números de novo se cancelar. As cobranças recorrentes dos números continuam durante esse período.

Para cancelar, selecione Cancelar exclusão no banner, ou selecione Excluir equipe de novo e depois Cancelar exclusão. Qualquer proprietário da equipe pode cancelar, sem confirmar a identidade de novo. O cancelamento restaura a equipe imediatamente: envios, chaves de API, campanhas e compras voltam a funcionar, e todos os proprietários recebem um e-mail com o nome de quem cancelou. Se o proprietário que agendou a exclusão for removido da equipe, perder a função de proprietário ou tiver a conta suspensa antes de a exclusão começar, a Polymorfa cancela a exclusão e envia um e-mail aos demais proprietários. Para excluir a equipe, um proprietário precisa agendar a exclusão de novo.

​

O que acontece no prazo final

O prazo para cancelamento termina 24 horas depois da confirmação. Depois desse prazo, a exclusão não pode ser cancelada, mesmo que um pagamento ainda esteja em processamento. A exclusão começa automaticamente quando nada a impedir. A equipe continua somente leitura enquanto aguarda. Quando a exclusão começa, a equipe deixa de aparecer para todos os membros, incluindo os proprietários. Links para as páginas dela no Console abrem outra equipe da qual você participa, e as chaves de API e os tokens de projeto dela são rejeitados como credenciais inválidas. Em seguida, a equipe exclui cada um dos seus números da mesma forma que um número individual é excluído: o número é desconectado, o acesso ao WhatsApp e a conexão com a Cloud API são removidos, e o histórico de mensagens hospedado e os registros de janela de atendimento e de preços da Cloud API são apagados. As campanhas são canceladas e a entrega de webhooks é desativada. A equipe e o acesso dos membros são removidos depois que todos os números forem limpos. Excluir um número da Cloud API na Polymorfa não exclui o número nem a conta do WhatsApp Business na Meta. Os registros de cobrança e o log de auditoria da equipe são mantidos. Se precisar de ajuda com uma exclusão já iniciada, fale com o suporte. Se a Polymorfa excluir uma equipe, por exemplo a seu pedido pelo suporte, a exclusão começa imediatamente, sem a janela de 24 horas, e não pode ser cancelada.

​

Gerencie projetos pela API

Use uma chave de equipe para listar projetos, criar um projeto ou solicitar a inscrição em produção. A API também permite ler a sua equipe e os membros dela. Consulte os métodos de projeto e equipe para ver os campos da solicitação e os escopos necessários. Altere as configurações da equipe, convide membros e gerencie as funções dos membros no Console, com a sua conta conectada.

​

Próximos passos