# Integração SONAX Pabx

![Integração SONAX Pabx](https://chat.simplesdesk.com.br/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBOGRsQmc9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c88c2c43f1914af58ad0164287851e05a568b773/simplesdesk-sonax.png)

Conecte o **PABX Virtual SONAX** ao SimplesDesk e una telefonia e WhatsApp: cada ligação atendida, perdida ou encerrada vira um **gatilho de fluxo** com os dados da chamada (duração, gravação, atendente), e os nós de fluxo disparam **click2call** ou inserem o contato numa **campanha discadora** — a ligação nasce da conversa, e o resultado da ligação volta para a conversa.

## Quando utilizar

- Operações que combinam telefonia SONAX com atendimento WhatsApp;
- **Follow-up automático de chamada perdida** — o cliente ligou e ninguém atendeu? Ele recebe um WhatsApp na hora;
- Botão "me liguem agora": um fluxo dispara o **click2call** e o PABX conecta atendente e cliente.

## Como conectar

1. Acesse **Configurações → Integrações** e clique no card **SONAX Pabx**.
2. Preencha o **ID Cliente** e o **Token** de integração fornecidos pela SONAX (dados de ativação da API de voz) e clique em **Conectar**.
3. A página da integração exibe a **URL de integração (SONAX → SimplesDesk)**: cole-a nas configurações do seu PABX SONAX — na URL da fila, da campanha e principalmente na **URL DE DESLIGAMENTO**. A SONAX substitui os campos `<VARIAVEL>` automaticamente — **não altere os parâmetros**.

As credenciais habilitam os nós de ligação (click2call e campanhas); os gatilhos de ligação funcionam pela URL de integração.

---

## Gatilho "Evento de integração"

Com a URL colada no PABX, cada aviso de status vira um evento que pode iniciar fluxos. No editor, crie um fluxo com o gatilho **Evento de integração**, integração **SONAX Pabx**, e escolha o evento:

- **Chamada atendida**
- **Chamada perdida**
- **Chamada encerrada**

Selecione também a **inbox** (canal) por onde a conversa do fluxo será criada — sem ela o evento é ignorado. O contato é identificado pelo número da ligação (criado automaticamente se não existir) e os dados da chamada chegam como variáveis:

`variables.sonax_status` · `variables.sonax_numero` · `variables.sonax_duracao` · `variables.sonax_gravacao_url` · `variables.sonax_atendente` · `variables.sonax_id_fila` · `variables.sonax_tabulacao`

> ⚠️ Somente eventos **terminais** geram gatilho — status intermediários como "discando" ou "falando" são ignorados. A gravação e a tabulação chegam no aviso de **desligamento** (por isso a URL DE DESLIGAMENTO é a mais importante).

### Exemplo: resgate de chamada perdida

1. Gatilho **Evento de integração** → SONAX Pabx → **Chamada perdida**, com a inbox de WhatsApp da operação;
2. **Enviar Mensagem**: "Olá! Vimos que você nos ligou e não conseguimos atender 😔 Já estamos aqui — como podemos ajudar?";
3. Complete com **Atribuir a time** ou etiquetas para priorizar o retorno.

---

## Nós de fluxo

No editor de fluxos, a paleta ganha a categoria **SONAX** (visível com a integração conectada):

- **SONAX: Ligar (ramal)** — dispara um click2call do ramal configurado para o número do contato (ou outro número/variável). Saída verde = ligação solicitada, vermelha = erro;
- **SONAX: Ligar (fila)** — igual, mas a ligação parte de uma **fila** do PABX;
- **SONAX: Inserir em campanha** — insere o número do contato numa **campanha discadora** da SONAX (com prioridade opcional).

Nos nós de click2call, o SimplesDesk envia o ID da conversa junto com a ligação — ele retorna no aviso de desligamento, casando a ligação com a conversa de origem. Se o campo "Número de destino" ficar vazio, o telefone do contato é usado. Variáveis gravadas: `variables.sonax_call_requested` · `variables.sonax_campaign_inserted` · `variables.sonax_erro`

### Exemplo: "quero falar com alguém agora"

1. No fluxo de atendimento, um botão **"Me liguem"** leva ao nó **SONAX: Ligar (fila)** com a fila comercial;
2. **Enviar Mensagem**: "Prontinho! Nossa equipe vai te ligar em instantes 📞";
3. Quando a ligação termina, o evento **Chamada encerrada** (ou **perdida**, se não atender) pode iniciar o fluxo de pós-ligação — pesquisa de satisfação, reagendamento, nova tentativa.

> 📗 Para dominar o editor, veja os tutoriais da categoria **Fluxos** — inclusive o do gatilho "Evento de integração".

> 📘 Precisa de ajuda? Fale com nosso suporte pelo chat — é só chamar.