--- title: "Referência de configurações da organização" description: "Gerencie uma organização do ThunderPhone: perfil, idioma do painel, membros, confirmação de chamadas de saída, quem liga bloqueado, webhooks, SSO, chaves de API, alertas, faturamento, limites de gastos e histórico." --- Abra **Configurações da organização** (`/dashboard/organization`) para gerenciar a organização ativa e sua própria conta. As configurações são divididas em seis abas; sua função determina quais controles você pode alterar. ## Minha conta A aba **Minha conta** contém configurações para o usuário conectado, não para toda a organização: - Nome, sobrenome, e-mail e uma URL de avatar. - Idioma de exibição do painel. - Download do aplicativo desktop para macOS. - Adicionar, verificar, listar e remover chaves de acesso. - Preferências de cookies. - Sair no dispositivo atual. Quando você entra por SSO da organização, o provedor de identidade gerencia seu e-mail, que fica somente leitura aqui. Consulte [Conta e segurança](/pt/guides/account-and-security) para o fluxo detalhado de chaves de acesso e perfil. ## Geral ### Conformidade de chamadas de saída Para organizações às quais o requisito se aplica, um proprietário ou administrador deve revisar e registrar a confirmação única de chamadas de saída antes que os agentes possam fazer chamadas de saída. Os membros podem ver que a ação é necessária, mas não podem enviá-la. Consulte [Leis sobre chamadas de saída](/pt/guides/outbound-calling-laws). ### Relatórios Fuso horário, horário comercial semanal e os próprios números de teste da organização. O horário comercial determina quais chamadas são consideradas fora do horário comercial nos números do relatório de chamadas na página Inicial, na aba **Chamadas** de cada agente e nos Portais do Cliente, além do filtro **Horário comercial** no Histórico de chamadas. Sem nenhum dia marcado, as chamadas fora do horário comercial não são registradas e todas as chamadas contam como horário comercial. Chamadas de ou para um número de teste ficam fora de todas as contagens de relatórios, listas de portais, números de Visão geral e exportações CSV; elas não podem ser abertas em um portal. Um agente pode ter seu próprio fuso horário e horário comercial em **Relatórios** no criador de agentes, que então se aplicam apenas às chamadas desse agente. Proprietários e administradores alteram essas configurações em **Geral → Relatórios**. Escolha o fuso horário e marque cada dia de funcionamento; depois, informe os horários de abertura e fechamento. Em **Números de teste**, informe cada número e selecione **Adicionar**. Em seguida, selecione **Salvar configurações de relatórios**. Até que um fuso horário seja salvo, os relatórios usam UTC; a página sugere o fuso horário do seu navegador como uma alteração não salva. Depois que qualquer horário comercial for definido, os dias não marcados serão considerados fora do horário comercial para chamadas que usam essa programação. #### Configurar relatórios pela API Proprietários e administradores podem usar `PATCH /v1/orgs/{id}/` com `timezone`, `business_hours` e `excluded_numbers`: - `timezone`: um nome de fuso horário IANA, como `America/Los_Angeles`, com até 64 caracteres. - `business_hours`: chaves de dias da semana de `mon` a `sun`, cada uma com uma lista de até quatro intervalos `{start, end}` em `HH:MM` de 24 horas, com cada horário de término posterior ao horário de início. `{}` significa que não há divisão de horário fora do horário comercial. - `excluded_numbers`: até 50 números de telefone, armazenados no formato E.164. Um número norte-americano de 10 dígitos sem código do país recebe o código de país `+1`. ```bash curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \ -H "Authorization: Bearer sk_live_YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "timezone": "America/Los_Angeles", "business_hours": { "mon": [{"start": "09:00", "end": "17:00"}], "sat": [{"start": "10:00", "end": "14:00"}] }, "excluded_numbers": ["+14155550199"] }' ``` ### Números de quem liga bloqueados Os números desta lista não podem entrar em contato com seus agentes. Quando um número bloqueado liga para qualquer um dos números de telefone da sua organização, o ThunderPhone encerra a chamada antes que um agente atenda e não cobra pela chamada. Ela ainda aparece no Histórico de chamadas como uma chamada recebida com falha, com o motivo de encerramento **Quem liga bloqueado**. Chamadas com identificador de quem liga oculto ou anônimo nunca são correspondidas, e chamadas feitas para um número bloqueado não são afetadas. Quem liga que você bloquear durante uma chamada não será desconectado; o bloqueio será aplicado a partir da próxima chamada. Todos os membros podem ver a lista; proprietários e administradores a alteram em **Geral → Números de quem liga bloqueados**: - Para bloquear um número, informe-o com uma observação opcional e selecione **Bloquear número**. Use `+` e o código do país; um formato nacional como `(415) 555-0123` também funciona quando todos os números de telefone da sua organização estão em um único país. - Para bloquear vários números de uma vez, selecione **Colar uma lista**, cole até 500 números (um por linha ou separados por vírgulas) e envie. O resultado mostra quantos foram adicionados, já estavam bloqueados ou são inválidos, e lista as entradas inválidas. - Para desbloquear um número, selecione **Remover** na linha correspondente e confirme. Você também pode abrir uma chamada recebida no **Histórico de chamadas** e selecionar **Bloquear esta pessoa que liga**. Uma organização pode bloquear até 10.000 números. Para gerenciar a lista pela API, consulte [Quem liga bloqueado](/api-reference/blocked-callers). ### Identidade e membros da organização O cartão da organização mostra o ID da organização, sua função de membro e o nome editável da organização. O cartão da equipe combina membros ativos e convites pendentes. | Função | Acesso típico | | --- | --- | | **Membro** | Criar e operar agentes e revisar chamadas. | | **Administrador** | Acesso de membro, além da administração de equipe, chaves, portais, conexões, alertas, faturamento e segurança. | | **Proprietário** | Acesso de administrador, além de ações da organização no nível de propriedade. | Proprietários e administradores podem convidar um **Membro** ou **Administrador**, revogar um convite pendente, alterar funções de membros elegíveis e remover membros. Os convites são específicos para cada e-mail e expiram após sete dias. Consulte [Convide sua equipe](/pt/guides/invite-your-team). A zona de perigo permite que um usuário elegível saia de uma organização ou a exclua permanentemente. A exclusão remove os agentes, números, histórico de chamadas e dados de faturamento da organização e não pode ser desfeita. Para excluir sua própria conta, abra a aba **Conta** e escolha **Excluir conta**. A caixa de diálogo lista as organizações que serão excluídas (aquelas em que você é o único membro) e as que você deixará. As chaves de API que você criou em uma organização que você deixa são revogadas. A exclusão é bloqueada enquanto você for o único proprietário de uma organização que tenha outros membros (primeiro torne outra pessoa proprietária), enquanto você tiver criado vozes personalizadas em uma organização que permanece, enquanto uma chamada estiver em andamento ou enquanto houver uma retenção legal; a caixa de diálogo lista o que estiver bloqueando a exclusão. Não é possível desfazê-la. ### Webhook padrão Defina uma URL de webhook legada para receber eventos de todos os widgets da web e números de telefone da organização. Para segredos por endpoint, assinaturas, histórico de entrega e novas tentativas, use os recomendados [endpoints de webhook](/pt/webhooks/endpoints). ### SSO empresarial Configure uma ou mais conexões de SSO, domínios de e-mail permitidos, provisionamento just-in-time, a função padrão e mapeamentos opcionais de grupo para função. A política de segurança pode exigir SSO, permitir acesso de emergência por senha para administradores e exigir chaves de acesso para acesso à organização. Consulte [SSO](/pt/guides/sso). ## Chaves A aba **Chaves** gerencia chaves secretas de API do servidor `sk_live_`. Cada linha mostra o nome, prefixo, estado ativo/revogado, hora de criação, último uso e hora de revogação. O segredo completo é exibido apenas uma vez, imediatamente após a criação. Copie-o nesse momento e armazene-o em um gerenciador de segredos. A revogação é permanente e interrompe toda integração que usa a chave. Consulte [Chaves de API](/pt/guides/api-keys). As chaves publicáveis `pk_live_` pertencem aos **Widgets da Web**, pois são credenciais de navegador restritas à origem, e não chaves de servidor. ## Alertas Crie regras de métricas para taxa de sucesso, taxa de falha, pontuação média, volume de chamadas ou regressões de suíte. Uma regra inclui: - Comparador e limite numérico. - Janela de avaliação de 1 a 720 horas. - Até 10 destinatários de e-mail. - URL opcional de webhook de entrada do Slack. - Entrega opcional para webhook de desenvolvedor. - Período de espera em minutos inteiros e estado ativado. A mesma aba lista disparos recentes. Consulte [Alertas](/pt/guides/alerts). ## Configurações de faturamento Gerencie o saldo e o comportamento de pagamento da organização: - Adicione ou substitua o cartão de pagamento padrão. - Adicione fundos manualmente. - Ative a recarga automática e defina seu limite e valor de recarga. - Defina ou remova um limite mensal de gastos. O limite mensal pausa novas chamadas e o uso em 100% e permanece ativo mesmo quando a recarga automática está desativada. Consulte [Preços](/pt/guides/pricing) e [Faturamento e recargas](/pt/guides/billing-and-topups). ## Histórico de faturamento Use **Histórico de faturamento** para verificar o saldo e os gastos de Hoje, 7 dias, 30 dias, 90 dias ou todo o período. Inclui: - Tendência de saldo. - Composição do faturamento entre cobranças de chamadas, relatórios, taxas de números de telefone e recargas. - Maiores gastos por agente. - Tabela de transações com data, categoria, descrição, tipo, valor e saldo resultante. - Filtragem por categoria e exportação em CSV ou JSON do histórico exibido. O painel informa quando apenas as transações mais recentes são exibidas; linhas mais antigas além desse limite também não são incluídas na exportação. A [API de faturamento](/api-reference/billing) oferece suporte à paginação programática.