Roteiro: Criar/editar grupo de endpoints e associar membros¶
Perfil necessário: admin Menus usados: Roteamento, Plataforma Risco: médio (o grupo alimenta o dispatcher do OpenSIPS; peso/prioridade errados mudam para onde as chamadas saem) Rollback: remover o membro ou excluir o grupo; sincronizar e recarregar OpenSIPS
Pré-requisitos¶
- [ ] Endpoints já cadastrados (
Roteamento → Endpoints) para associação - [ ] Definição de carga: quantos endpoints ativos em paralelo, pesos iguais ou diferentes, prioridades
Passo a passo¶
1. Criar o grupo¶
Caminho: Roteamento → Grupos
Clique: [Novo Grupo] (toolbar da listagem)

Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome | sim | clientes-voip-sp |
identificador do grupo (usado pelo dispatcher) |
| Descrição | não | texto livre | propósito do grupo |
| Canais | não | inteiro ≥ 0 | teto de canais do grupo (0 = sem limite) |
| CPS | não | inteiro ≥ 0 | teto de chamadas por segundo do grupo |
Clique: [Criar] (footer do dialog)

Resultado esperado: dialog fecha, toast "Criado", grupo na listagem com Canais/CPS e coluna Membros com botão [Ver].
Para editar um grupo existente: ícone de lápis na linha (tooltip Editar) abre o mesmo dialog com título Editar Grupo; o botão do footer vira [Salvar].
2. Abrir os membros do grupo¶
Clique: [Ver] na coluna Membros da linha do grupo

Resultado esperado: dialog Membros: <nome do grupo> com tabela Endpoint / Peso / Prioridade / Atualizado / Ações.
3. Associar endpoints ao grupo¶
Na barra superior do dialog de membros:
Preencha:
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Seletor de endpoints (MultiSelect) | sim | chips com nome do endpoint | endpoints a adicionar; opções marcadas Já no grupo aparecem desabilitadas |
| Peso | não | inteiro ≥ 0 (default 100) |
distribuição de carga entre membros de mesma prioridade |
| Prio | não | inteiro ≥ 0 (default 0) |
menor prioridade é tentado primeiro; seguinte só em failover |
Clique: [+] (botão com ícone de adicionar à direita do Prio)

Resultado esperado: toast "1 membro adicionado" (ou "N membros adicionados"); membro na tabela com peso/prioridade aplicados. Seleção é limpa após adicionar. Endpoints já presentes geram aviso "N endpoint(s) não foram adicionados" sem interromper os demais.
4. Remover um membro (quando necessário)¶
Clique: ícone de lixeira na linha do membro (tooltip Excluir)
Resultado esperado: toast "Removido"; membro some da tabela e volta a aparecer como Disponível no MultiSelect.
5. Sincronizar e recarregar OpenSIPS¶
O backend re-sincroniza o dispatcher a cada mudança de membro, mas o reload de memória é explícito:
Caminho: Plataforma → Sistema → OpenSIPS (Reload)
Clique: [Recarregar todos os módulos] — cobre dispatcher (ds_reload) e address

Resultado esperado: mensagem de sucesso por módulo; ds_list no MI reflete os destinos do grupo.
Validação¶
- [ ] Visual: grupo na listagem; dialog Membros lista os endpoints com peso/prioridade corretos
- [ ] Funcional:
opensips-cli -x mi ds_listmostra os destinos do grupo na ordem de prioridade - [ ] Falha proposital: derrubar o endpoint de maior prioridade e conferir que o tráfego cai para o próximo (failover)
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Opção do endpoint desabilitada no MultiSelect | endpoint já é membro do grupo | remover o membro antes de re-adicionar |
| Toast "N endpoints não foram adicionados" | parte da seleção já estava no grupo | conferir a tabela de membros; os demais foram adicionados |
| Tráfego não passa pelo novo membro | dispatcher não recarregado | executar reload (passo 5) |
| Peso/prioridade não mudam comportamento | membros em prioridades diferentes: peso só vale dentro da mesma prioridade | ajustar prio/weight coerentes com o desenho de carga |
| Grupo excluído mas destinos ainda ativos | reload pendente após exclusão | sincronizar e recarregar dispatcher |
Impacto operacional¶
- Canais/CPS do grupo são tetos agregados; somam-se aos limites por linha/endpoint — não duplique proteção sem revisar.
- Prioridade é failover, peso é carga simultânea. Peso igual + prioridades distintas = ativo/passivo.
- Toda mudança de membros muda o destino das chamadas em produção; mude em janela e confirme com chamada de teste.