Gatilhos
O separador Gatilhos permite que o seu agente trabalhe em segundo plano, sem ninguém em linha. Quando algo acontece — chega um e-mail, termina uma chamada, entra um lead, o seu sistema envia um webhook ou simplesmente chega uma hora definida —, o agente pode primeiro fazer uma tarefa (ler o e-mail, preparar um rascunho, decidir se é importante) e depois ligar para o número que escolher.
Os gatilhos não estão disponíveis no plano Free. Precisam de um plano pago (Starter, Pro, Business ou Enterprise) e de saldo de créditos (ou recarga automática) quando um gatilho dispara. No plano Free ainda pode desativar ou eliminar um gatilho, mas não criar nem ativar.
As chamadas dos gatilhos saem do número do campo Ligar de do gatilho; se não houver, do número de saída do agente; se também não houver, do número em que o agente atende. Consulte Números de Telefone.
Como funciona um gatilho
Cada gatilho tem três partes, que correspondem às três secções do formulário do gatilho:
| Secção | O que define |
|---|---|
| Quando | O evento que inicia o gatilho e os seus filtros |
| Antes da chamada | Uma tarefa opcional para o agente e se deve ligar sempre ou deixar o agente decidir |
| Para quem ligar | Um número fixo ou o número do evento, o número de onde ligar, as tentativas e a pausa entre elas |
Uma quarta secção, Limites, protege a pessoa para quem se liga: horário de silêncio, chamadas por hora e por dia e proteção contra repetições.
O fluxo em cada evento:
- O evento chega e é comparado com os filtros do gatilho.
- Se o gatilho tiver uma tarefa, o agente fá-la em segundo plano. Pode pesquisar e ler nas caixas de correio e ficheiros ligados e preparar rascunhos de resposta, mas em segundo plano não envia nada além de um resumo para o E-mail do proprietário fixo.
- Com Sempre ligar, o agente liga após cada evento. Com Deixar o agente decidir, só liga se a tarefa mostrar que vale a pena — por exemplo, apenas para e-mails importantes.
- A chamada sai do número de saída do agente, com o que o agente encontrou já no seu contexto.
Eventos
| Evento | Dispara quando | Filtros |
|---|---|---|
| Novo e-mail | Chega um novo e-mail a uma caixa de correio ligada — Gmail, Outlook ou IMAP | Remetente contém, assunto contém, texto contém, apenas e-mails com anexos. Todos os filtros preenchidos têm de corresponder; maiúsculas e minúsculas não importam |
| Chamada encerrada | Termina uma chamada deste agente | Tipo de chamada (qualquer, recebida, realizada, chamada web), resultado (qualquer, chamada curta, transferência falhou, caixa postal, sem resposta, conversa concluída), mais longa que / mais curta que (segundos), resumo contém |
| Novo lead | É captado um lead | ID do formulário — deixe vazio para reagir a leads de qualquer formulário |
| Webhook | O seu sistema envia um POST para o URL próprio do gatilho | Campo do telefone na requisição — um caminho no corpo JSON, p. ex. phone ou customer.phone |
| Agendamento | Chega uma hora definida | Uma vez, todos os dias, dias úteis (seg–sex), toda semana, todo mês |
| SMS recebido | Chega um SMS ao número do agente | Texto contém — deixe vazio para reagir a qualquer SMS |
| Evento do calendário | Aproxima-se um evento do calendário Google ou Outlook | Minutos antes do evento (5–2880), onde encontrar o número de telefone (descrição do evento, local do evento, telefone do participante) |
| Arquivo do Google Drive | Um ficheiro aparece ou muda no Google Drive | Arquivo novo ou alterado, pasta, nome contém, tipo de arquivo (documento, planilha, apresentação, PDF, pasta) |
- Novo e-mail precisa da caixa de correio ligada em Integrações e da ferramenta de e-mail correspondente adicionada ao agente, para que o agente possa ler o e-mail em segundo plano. Consulte Email.
- Arquivo do Google Drive só vê as pastas e ficheiros que partilhou com o agente em Integrações, mais os ficheiros criados pelo próprio agente. Consulte Google.
- Chamada encerrada só conta as chamadas deste agente. As chamadas feitas por gatilhos ou retornos de chamada nunca iniciam um gatilho, por isso os gatilhos não podem entrar em ciclo.
- O agendamento usa o fuso horário do agente. Uma chamada mensal no dia 31 é feita no último dia dos meses mais curtos.
URL do webhook
Depois de guardar um gatilho de webhook, o seu URL aparece no formulário e no menu do gatilho (Copiar URL do webhook).
- Envie um pedido
POSTcom um corpo JSON de até 64 KB. - Mantenha o URL em segredo: quem o tiver pode iniciar o gatilho.
- Nova URL cria um novo endereço; o antigo deixa de funcionar de imediato.
- Nunca chame o URL a partir de um navegador. Se for divulgado, clique de imediato em Nova URL. Trate o corpo do pedido como dados não fiáveis.
Para quem ligar
| Definição | Descrição | Predefinição |
|---|---|---|
| Número fixo / Número do evento | Ligar sempre para o mesmo número ou para o número que o evento traz: a outra parte da chamada, o telefone do lead, o remetente do SMS, o campo do telefone do webhook, o telefone encontrado no evento do calendário | Número fixo |
| Número de telefone | Para um número fixo — formato internacional com + e indicativo do país, sem espaços | — |
| Ligar de | De que número de saída ligar | O número de saída do agente |
| Tentativas | Quantas vezes tentar se ninguém atender (1–5) | 3 |
| Minutos entre tentativas | Pausa entre tentativas (1–120) | 10 |
Os eventos sem número de telefone próprio (novo e-mail, agendamento, ficheiro do Google Drive) ligam sempre para um número fixo.
Limites
| Definição | Descrição | Predefinição |
|---|---|---|
| Horário de silêncio | As chamadas que caem neste intervalo esperam que termine | Ativo, 21:00–08:00 no fuso horário do agente |
| Chamadas por hora, no máximo | 1–100 | 10 |
| Chamadas por dia, no máximo | 1–500 | 50 |
| Ignorar repetições por (minutos) | O mesmo evento ou o mesmo número dentro deste tempo inicia apenas uma chamada. 0 desativa a proteção (0–1440) | 60 |
Limites de toda a plataforma:
- Até 50 gatilhos por agente.
- Até 200 tarefas em segundo plano por conta por dia.
- Um URL de webhook aceita até 30 pedidos por minuto.
Durante uma chamada, as ferramentas do agente têm os seus próprios limites de segurança: no máximo 3 e-mails por conversa (ou, em vez disso, até 5 rascunhos), no máximo 2 retornos de chamada por chamada e, antes de enviar um e-mail, eliminar um ficheiro ou substituir o texto de um ficheiro, o agente lê-o em voz alta e só age após um «sim» claro da pessoa em linha. Numa tarefa em segundo plano, o agente não envia nada além de um resumo para o E-mail do proprietário fixo; um rascunho só sai após um «sim» durante a chamada. Para cada ferramenta pode também escrever uma regra por palavras suas. Consulte Ações e Ferramentas.
Modelos
Ver modelos abre uma galeria de gatilhos prontos; no passo seguinte pode alterar tudo. Começar do zero permite escolher o evento, a tarefa e a chamada por si.
| Grupo | Modelo | O que faz |
|---|---|---|
| Me ligue sobre e-mails importantes | Lê cada novo e-mail e só lhe liga se for urgente ou importante | |
| Me ligue quando um certo remetente escrever | Liga-lhe com um breve resumo de cada e-mail do remetente escolhido | |
| E-mails com anexos | Lê os anexos, extrai valores e datas e prepara um rascunho de resposta, se necessário | |
| Nova fatura por e-mail | E-mails que mencionam «Rechnung»: encontra o valor, a data de vencimento e o IBAN e liga-lhe | |
| Resumo matinal de e-mails | Nos dias úteis às 08:30 revê os e-mails não lidos desde ontem e liga-lhe com os 5 principais | |
| Google Drive | Novo arquivo no Drive — ler e ligar | Lê um novo ficheiro e liga-lhe com o essencial |
| Novo PDF em uma pasta — conferir a fatura e ligar | Encontra o valor, a data de vencimento, o IBAN e o remetente de um novo PDF na pasta escolhida | |
| Documento atualizado — ligar | Liga se o documento alterado tiver algo substancial | |
| Planilha atualizada — ligar se for relevante | Só liga se surgirem novas tarefas ou encomendas | |
| Por agendamento | Chamada diária · Chamada semanal · Chamada mensal · Chamada única | Liga para um número à hora escolhida |
| Após chamadas | Retornar após uma chamada curta | Uma chamada recebida terminou em menos de 20 segundos — o agente retorna a chamada |
| Retornar após uma transferência falha | A transferência para um colega falhou — o agente liga de volta a quem ligou | |
| Tentar de novo quando ninguém atendeu | Após uma chamada de saída sem resposta, tenta novamente mais tarde | |
| Tentar de novo após caixa postal | Uma chamada de saída foi para a caixa postal — volta a ligar daqui a uma hora | |
| Me avise sobre clientes insatisfeitos | Só lhe liga se quem ligou estava insatisfeito ou pediu um responsável | |
| Resumo da chamada para o gerente | Após cada conversa concluída com mais de 30 segundos, liga ao gerente com um resumo | |
| Leads e webhooks | Ligar para novos leads imediatamente | Liga a um novo lead em menos de um minuto; graças ao horário de silêncio, os leads da noite recebem a chamada de manhã |
| Me avise sobre novos leads | Liga-lhe com o nome, o contacto e o pedido do lead | |
| Ligar para o cliente a partir do seu sistema | O seu CRM, loja ou formulário envia um pedido com um número — o agente liga para esse número | |
| Me avise a partir do seu sistema | Qualquer sistema envia um pedido — o agente liga-lhe e diz o que aconteceu | |
| SMS e calendário | Retornar após um SMS | Alguém escreve para o número do agente — o agente liga-lhe de volta |
| Me avise sobre SMS recebidos | Liga-lhe e diz quem escreveu e o que pretende | |
| Lembrete de compromisso | Duas horas antes de um evento do calendário, liga para o número do evento |
Testes e execuções recentes
Testar agora no menu de um gatilho executa-o de imediato, como se o evento tivesse acabado de acontecer. Pode passar dados de exemplo do evento em JSON — por exemplo, o número de telefone para um webhook. O horário de silêncio e a proteção contra repetições são ignorados; os limites por hora e por dia continuam a contar. Isto faz uma chamada real.
Execuções recentes mostra o que os gatilhos fizeram, juntamente com os retornos de chamada que o agente prometeu durante as chamadas (a ferramenta Retornar ligação depois). Cada execução tem um estado:
| Estado | Significado |
|---|---|
| Aguardando / Em andamento | À espera da sua vez ou a fazer a tarefa em segundo plano |
| Chamada na fila / Ligando | A chamada espera pelo seu momento ou está a tocar |
| Concluído | Terminado |
| Chamada não necessária | O agente decidiu que não valia a pena ligar |
| Retido | Parado por um limite — horário de silêncio, limite por hora ou por dia, uma repetição recente |
| Falhou | Algo correu mal — por exemplo, sem número de saída, sem telefone no evento, Google Drive não ligado |
| Cancelado | A execução foi cancelada |
Faturação
A tarefa em segundo plano em si não é cobrada. A chamada feita por um gatilho é faturada como qualquer outra chamada de saída, primeiro a partir dos créditos do plano e depois das recargas. Se o saldo estiver vazio e a recarga automática desativada, a execução falha antes de ligar. Consulte Faturação e Subscrições.
Relacionado
- Ações e Ferramentas — as ferramentas que o agente usa nas chamadas e nas tarefas em segundo plano
- Email — ligar o Gmail, o Outlook ou uma caixa de correio IMAP
- Google — Calendar, Gmail, Drive, Contacts e Tasks
- Números de Telefone — atribuir um número de saída
- Campanhas — chamadas de saída para uma lista de contactos