Telefonia e chat (CallSys e Blip)
Estes nós conversam com as duas plataformas de atendimento: o CallSys, que reúne telefonia e chat numa central só, e o Blip, que cuida das conversas e do WhatsApp. Eles aparecem na paleta do editor em Integrações, sob CallSys e Blip.
Com eles você monta automações como: montar a carga do discador toda manhã a partir da lista de inadimplentes, ligar para o cliente assim que o chamado é aberto, responder um ticket de WhatsApp quando o processo termina, ou avisar por template sobre um vencimento.
O que vale para todos
- Escolha a credencial no topo do nó.
- Todo campo de texto aceita
{{ … }}com dados do item, então o mesmo nó atende um lote inteiro (um telefone por item, por exemplo). - Todos têm uma saída (
main). - Os nós de consulta emitem um item por registro; os de ação devolvem o
item acrescido de
_callsysou_blip. - Na aba Config ficam Timeout (segundos) (padrão 60) e Saída do nó (Mesclar item ou Substituir item) — veja Ajustes do nó.
Os nós
| Nó | Serve para | Credencial |
|---|---|---|
| CallSys — Contato (criar/atualizar) | Manter o cadastro do contato, com telefones e carteira | CallSys |
| CallSys — Campanha do discador | Listar campanhas ou montar uma carga de contatos | CallSys |
| CallSys — Ligação (ClickToCall) | Originar, acompanhar e encerrar uma chamada | CallSys |
| CallSys — Relatório de chamadas | Consultar as chamadas por período, número e situação | CallSys |
| CallSys — Tickets do chat | Consultar, responder e encerrar atendimentos do chat | CallSys |
| CallSys — WhatsApp (template) | Enviar template aprovado e acompanhar o envio | CallSys |
| Blip — Enviar mensagem | Texto ou template de WhatsApp pelo Blip | Blip |
| Blip — Comando (extensões) | Contatos, tickets, agendamentos e demais recursos do Blip | Blip |
CallSys
CallSys — Contato (criar/atualizar)
O contato é identificado pelo CPF ou pelo CNPJ — informe um dos dois. Os demais campos são Nome, Sobrenome, E-mail, Telefones (um por linha, com DDD), Código de integração (o identificador da pessoa no seu sistema) e a Carteira, que é o login do usuário responsável.
Dados que a sua central usa e não estão na lista — razão social, endereços, equipes da carteira — vão em Campos adicionais (JSON).
Sai o item com _callsys.contato.
CallSys — Campanha do discador
Duas operações:
| Operação | O que informar |
|---|---|
| Listar campanhas | Filtro pelo nome (opcional) e o máximo de campanhas |
| Criar carga com os items do fluxo | A campanha, o nome da carga e de onde tirar cada dado do contato |
Na criação da carga, os items do fluxo viram as linhas da carga: em cada campo
— Nome do contato, Telefone 1, Telefone 2, Telefone 3, Documento,
Descrição, Código de integração — você escreve de onde vem o valor, com
{{ … }}. Se a etapa anterior trouxe quinhentas pessoas, a carga sai com
quinhentas linhas.
O Nome da carga precisa ser único dentro da campanha: repetir o nome é recusado.
Um nome com a data, como Cobrança {{ hoje }}, resolve. Habilitar a carga ao
criar já a deixa pronta para o discador.
Para descobrir o ID da campanha, rode antes a operação Listar campanhas.
Sai o item com _callsys.carga.
CallSys — Ligação (ClickToCall)
| Operação | O que informar |
|---|---|
| Originar chamada | O Ramal (que precisa estar registrado no PABX), o Número de destino e um Identificador escolhido por você |
| Consultar chamada | O mesmo identificador |
| Desligar chamada | O mesmo identificador |
O Identificador é a chave de tudo: é você quem o escolhe ao originar a chamada, e é por ele que as operações seguintes encontram a ligação. Use algo que o fluxo já tenha, como o número do chamado.
Sai o item com _callsys.originar, _callsys.chamada ou _callsys.desligar,
conforme a operação.
CallSys — Relatório de chamadas
Escolha o Relatório — Chamadas do discador ou Chamadas manuais —, o período (Início e Fim), e, se quiser, um Número (ou parte dele) e o Status da chamada: atendida, não atendida, ocupado, falhou, congestionamento ou caixa postal.
O resultado vem paginado: até 200 registros por página, e você escolhe a Página. Emite um item por chamada.
CallSys — Tickets do chat
Cinco operações:
| Operação | O que informar |
|---|---|
| Consultar tickets por período | Data inicial e final (em branco, as últimas 24 horas), registros por página e página |
| Panorama do momento | Nada — devolve quantos estão abertos, aguardando e no bot |
| Dados e mensagens de um ticket | O ID do ticket |
| Enviar mensagem num ticket aberto | O ID do ticket, o tipo (texto, imagem ou documento) e a mensagem ou a URL da mídia |
| Encerrar um ticket aberto | O ID do ticket |
Imagem e documento vão por URL pública: é o CallSys que busca o arquivo nesse endereço. Um arquivo que só existe dentro do item não chega ao destinatário — publique-o antes num endereço alcançável.
Sai o item com _callsys.tickets, _callsys.ticket, _callsys.mensagem ou
_callsys.encerrado, conforme a operação.
CallSys — WhatsApp (template)
| Operação | O que informar |
|---|---|
| Enviar template | Telefone, nome do template, configuração de bot, destino do atendimento e os parâmetros |
| Listar templates | Nada — devolve os templates aprovados |
| Consultar status de um envio | O identificador devolvido pelo envio |
No envio, o Telefone vai com código do país, DDD e número. O Nome do template é o que a operação Listar templates mostra. O ID da configuração de bot está na área de Chat/ChatBot da plataforma. Em Entregar o atendimento a, escolha se a conversa cai numa equipe, num usuário ou num fluxo de bot, e informe o identificador correspondente.
Os Parâmetros do template vão um por linha, na ordem esperada pelo template: a primeira linha preenche o primeiro espaço do texto, a segunda o segundo, e assim por diante.
Sai o item com _callsys.whatsapp, de onde sai o identificador do envio — é ele
que a operação Consultar status usa depois.
Para cadastrar a credencial CallSys
| Campo | Onde obter |
|---|---|
| URL da instância | O endereço da sua central |
| Token de API da empresa | Gerado no painel do CallSys |
Blip
Blip — Enviar mensagem
O campo Para leva a identidade completa do destinatário, no formato que o
canal usa. No WhatsApp é o telefone seguido do endereço do canal
(5531999999999@wa.gw.msging.net); no Blip Chat, o identificador da pessoa seguido
do endereço dele.
Em Formato:
- Texto simples — escreva o Texto da mensagem.
- Payload nativo do canal — cole o Payload (JSON) no formato do canal. É por aqui que se envia um template aprovado de WhatsApp, com nome, idioma e os componentes.
Sai o item com _blip.mensagem, com o identificador da mensagem enviada.
Fora da janela de 24 horas desde a última resposta do contato, o WhatsApp entrega apenas template aprovado. Por isso o formato de payload existe: é o caminho para iniciar a conversa.
Blip — Comando (extensões)
É o nó de uso geral do Blip: alcança as extensões da plataforma — contatos, tickets do atendimento humano, envios em massa, agendamentos e registro de eventos.
| Campo | Para quê |
|---|---|
| Destinatário | A extensão com que você quer falar, como postmaster@crm.msging.net |
| Método | get, set, merge, delete, subscribe ou unsubscribe |
| URI do recurso | O recurso dentro da extensão, como /contacts?$take=10 |
| Tipo MIME do resource | Só quando o comando envia conteúdo |
| Resource (JSON) | O corpo do comando nos métodos que gravam |
Sai o item com _blip.resposta.
Este nó é a porta de entrada para tudo o que o Blip oferece e ainda não virou um nó próprio. Consulte a documentação da extensão que você quer usar para saber o destinatário, o recurso e o formato do corpo.
Para cadastrar a credencial Blip
| Campo | Onde obter |
|---|---|
| ID do contrato | O identificador do seu contrato no Blip |
| Chave de acesso | A chave do bot, no painel do Blip |
Veja também: Credenciais, Mensageria e Ajustes do nó.