Gatilho: Chamada recebida

O gatilho Chamada recebida dispara no instante em que uma chamada recebida começa a tocar, antes de qualquer atendimento. É o gancho mais cedo disponível — útil para reagir o mais rápido possível, por exemplo registrando em tempo real que há uma chamada em andamento.

Quando usar

• Mostrar em um canal do Team quem está ligando agora, para que qualquer agente livre atenda.
• Criar o registro do contato no CRM assim que a chamada entra, mesmo antes de ser atendida.
• Disparar um webhook para um sistema externo (ex.: um CTI ou pop-up de tela) assim que o telefone toca.

Configuração do gatilho

• Canal específico: filtro padrão de chamadas.
• Direção: ⚠️ esse gatilho só é gerado para chamadas recebidas — escolher "Realizada" faz o gatilho nunca disparar, sem nenhum aviso. Deixe o filtro em "Recebida" ou vazio.

Variáveis disponíveis

Variáveis padrão de chamada e contato, mais:

• $is_new_contact — verdadeiro quando o número não tinha um registro de Contato antes desta chamada.

Passos

1. Crie ou abra uma automação.
2. Arraste "Chamada recebida" de Gatilhos de chamadas.
3. Filtre por canal se necessário; não escolha "Realizada" em Direção (veja o aviso acima).
4. Conecte uma ação, por exemplo "Avisar a equipe".
5. Ative e salve.

Exemplo

Você quer que a equipe veja no canal do Team "Chamadas" quem está ligando em tempo real. Conecte "Avisar a equipe" com: "📞 Chamada recebida de {{$contact.display_name}} ({{$call.from}}) pelo {{$channel.name}}."

Dicas

• Se você só quer reagir quando um agente realmente atende (não apenas quando toca), use o gatilho "Chamada atendida" em vez deste.
• Combine com "Primeira chamada do contato" (via $is_new_contact) para dar um tratamento diferenciado a leads novos desde o primeiro segundo.

Solução de problemas

Se você configurou o filtro Direção = Realizada e o fluxo nunca roda: isso é esperado, esse gatilho (e os que compartilham o mesmo evento base: "Primeira chamada do contato", "Contato recorrente" e "Chamada fora do horário") só é gerado para chamadas recebidas.