Referência de configurações da organização

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 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.

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.

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.

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.

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.

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.

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.

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.

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.

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 e Faturamento e recargas.

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 oferece suporte à paginação programática.