Skip to main content

Builder e APIs

Dúvidas sobre a construção do contato inteligente ou integrações? Compartilhe aqui!

  • 92 Tópicos
  • 296 Comentários
92 Tópicos
pabloquiroga
pabloquirogaSolver
perguntado em Builder e APIs
Como gerenciar troca de mensagens no Desk em um builder HTTP

Boa tarde, pessoal!Estou desenvolvendo um builder externo com conexão HTTP e em determinado ponto do fluxo abro um ticket no Desk. Quando o ticket está aberto as mensagens do cliente precisam chegar no operador e as mensagens do operador precisam chegar no cliente. Estou tentando usar as requisições que estão na documentação:https://docs.blip.ai/#forwarding-received-messages-to-a-human-agent https://docs.blip.ai/#forwarding-received-messages-from-a-human-agent-to-a-final-userAs mensagens não estão sendo encaminhadas, o mais próximo que cheguei foi um status 202 dizendo que a requisição foi aceita.Alguém poderia me explicar como essas requisições funcionam? Existem mais passos a serem feitos pra que dê certo? O canal é o WhatsApp, o builder HTTP está conectado em um roteador.É requisito do projeto que tudo aconteça no bot externo, então não posso usar a estratégia de abrir ticket em outro builder.

833
Felipe_Miranda
Blipper
M
MarkinSilvaNew Member
perguntado em Builder e APIs
[Dúvida] Redirecionamento entre bots via router não funcionando

Bom dia, pessoal! Tudo bem?Estou com uma dúvida sobre redirecionamento de serviço entre bots via router e queria saber se alguém pode me dar uma força 👇Hoje tenho um bot A que deveria fazer o redirect para um bot B. Já realizei as seguintes configurações: Ambos os bots estão cadastrados no router e com os serviços corretamente configurados. No bot A, criei um bloco específico de redirecionamento. Configurei esse bloco com: Ação de entrada: Redirect para serviço X (nome do serviço do bot B). Ação de saída padrão: Direcionamento para o bloco de início. Porém, na hora de testar, o redirecionamento não acontece — o fluxo segue como se nada tivesse sido redirecionado.Deixei um espaço aqui para anexar prints das configurações e do fluxo que estou utilizando:   Alguém saberia me dizer o que posso estar esquecendo ou se há algo adicional que preciso configurar?Desde já, valeu demais pela ajuda! 🙏

341
Lucas Ventura
B
Bruno FerreiraSpecialist
perguntado em Builder e APIs
Finalizar vários Tickets por api com tag específica

Bom dia !!! Alguém sabe como posso finalizar tickets por api com tag específica ? Pois estou tendo que finalizar eles manualmente e tenho mais de 500 pra fazer isso.

322
B
emedina
emedinaInspiring
perguntado em Builder e APIs
pergunta sobre redirecionamento em um roteador BLiP.

Olá comunidade,Tenho uma pergunta sobre redirecionamento em um roteador BLiP.E se um usuário for redirecionado automaticamente para um subbot por meio da API, mas nunca interagir (ou seja, não digitar nada antes ou depois)?Minha pergunta é: quanto tempo leva para o usuário digitar novamente antes que o fluxo comece novamente a partir do roteador e o envie para o bot principal como se fosse uma nova conversa?

211
Lucas Ventura
Wenner
WennerInspiring
postado em Builder e APIs
Envio de parâmetros na notificação

Como faço para enviar um parâmetro no envio da notificação pelo whatsapp, ex: idPessoa e recuperar no whatsapp quando a notificação for aberta?curl --location 'https://domain.http.msging.net/messages' \--header 'Authorization: Key {{}}' \--header 'Content-Type: application/json' \--data-raw '{    "id": "",    "to": "+{{number}}@wa.gw.msging.net",    "type": "application/json",    "content": {        "type": "template",        "template": {            "name": "template",            "language": {                "code": "pt_BR",                "policy": "deterministic"            },            "components": [                {                    "type": "body"                }            ]        }    }}' 

252
Lucas Ventura
Rvdada1911
Rvdada1911Inspiring
postado em Builder e APIs
Requisição HTTP sem retorno

Olá pessoal, boa tarde!Gente estou com uma dificuldade aqui para integrar uma API com o chat. O chat não emite a requisição na API e também não dá erro, nem retorna nada na variável de retorno, só marca como concluído no debbuger.Eu imaginava que era por conta da forma que o blip envia o content-type. Então criei um servidor intermediário para tratar os cabeçalhos e ajustar as requisições.Antes usava o NGROK para abrir a api intermediária para receber as requisições do Blip e estava funcionando, mas quando troquei para o DNS do cliente, novamente não está funcionando no Blip, só no postman.Olhando os logs da API intermediária, os testes que fiz com o postman funcionam, mas os testes que fiz com o Blip nem chegam na API. Eu já olhei tudo que tem no postman como cabeçalhos, forma do body e etc., e copiei no Blip, mas mesmo assim a requisição dele não chega na API.Alguma alma bondosa consegue me ajudar por getileza?

211
Marina Dias
Blipper | Community Manager
Matheus Protzen
Matheus ProtzenNew Member
postado em Builder e APIs
Evento de conversão lista somente flow como opção

Bom dia, estou configurando o Click Tracker e estou com um problema, quando eu vou selecionar o evento de conversão aparece pra mim apenas a opção flow.Fiz a configuração dentro do builder para a ação de entrada ser o registro de eventos com a configuração conforme informada pela doc (https://help.blip.ai/hc/pt-br/articles/16775881794327-Click-Tracker-Evento-de-Convers%C3%A3o-na-pr%C3%A1tica) e também fiz uma configuração mais simples de teste apenas com o nome da categoria e a ação, publiquei o fluxo e passei por ele (na expectativa que precisava ter o trigger para criar a categoria), mas mesmo assim continua só listando flow, alguém consegue me ajudar nisso?

162
Rafael_Figueiredo
Blipper
C
Cleverson SaraivaConnected
postado em Builder e APIs
Dashboard

Eu gostaria de acompanhar o monitoramento de filas como tickets em atendimento, na fila seria possível criar para ficar como painel para acompanhamento?   

264
Rafael_Figueiredo
Blipper
Rvdada1911
Rvdada1911Inspiring
perguntado em Builder e APIs
Requisição HTTP não chega à API

Olá pessoal, bom dia! Estou com uma dificuldade aqui. Estou fazendo uma requisição http, mas o chat não está retornando nada. Inicialmente imaginei que era a forma que ele envia o Content-Type para a API, então criei uma API intermediária que ajustar os cabeçalhos e o body da requisição. Estava funcionando quando eu estava usando o NGROK para abrir a API intermediária para acesso de fora, mas quando mudei para o DNS do cliente parou de funcionar novamente.No Postman está funcionando, mas no debugger do chat ele não retorna nem erro, só marca como concluído e segue o fluxo. Olhando os logs da API, a requisição do Postman aparece lá, mas a do chat não. Acredito que não está nem chegando a requisição na API.Alguém tem uma luz de como posso resolver ou o que está causando isso?

252
Rvdada1911
EmilianoRojas
EmilianoRojasConnected
postado em Builder e APIs
Enviar Template via Scheduler

Hola a todos! Estoy intentando enviar un template via Scheduler, a un dia y hora especificos. Este es el body de mi request:{"message":{"id":"{{random.guid}}","to":"{{contact.identity}}","type":"application/json","content":"{{template}}","when":"2025-04-04T14:20:00.000Z"}} Al hacer la request, el endpoint arroja el siguiente resultado:{ "method": "set", "status": "failure", "reason": { "code": 64, "description": "Unsupported resource type" }, ... Puedo enviar templates por aqui? Que debo adicionar para hacerlo? Saludos!

253
Marina Dias
Blipper | Community Manager
M
Maria_Eduarda_FerreiSolver
postado em Builder e APIs
Integração com RD Station

Bom dia, pessoal!Anteriormente, eu realizava a integração com o RD Station por meio de uma extensão gratuita que permitia registrar os eventos dos leads na plataforma. No entanto, percebi que essa extensão foi descontinuada.Tentei fazer a integração utilizando as APIs disponibilizadas pelo RD Station, mas estou recebendo o seguinte erro: `{"errors":{"error_type":"UNSUPPORTED_MEDIA_TYPE","error_message":"The payload is in a format not supported by this method on the target resource."}}`. Curiosamente, a mesma requisição funciona no Postman.Alguém sabe se há alguma limitação do Blip em relação ao RD Station e como posso contornar esse problema? Vale lembrar que estou ciente de que as tags não são suportadas; os únicos dados que estou tentando enviar são nome, e-mail e telefone. Agradeço desde já pela ajuda!

274
Rafael_Figueiredo
Blipper
C
Cleverson SaraivaConnected
perguntado em Builder e APIs
Salvar contatos

Como faço para salvar os contatos dos meus clientes para que quando eles entrem em contato, não precisem passar por todo fluxo de cadastro de nome, etc.

222
C
anjodaguarda
anjodaguardaConnected
perguntado em Builder e APIs
Distribuição automática e equilibrada de atendimentos para equipe

Gostaria de saber se é possível configurar o sistema para que cada membro da minha equipe de vendas tenha um limite máximo de atendimentos simultâneos, de forma parecida com o que acontece na distribuição automática de tickets.Além disso, gostaria de entender se os novos atendimentos podem ser atribuídos automaticamente e de forma equilibrada, respeitando esse limite por pessoa. A ideia é garantir que todos recebam uma quantidade justa de atendimentos, sem sobrecarregar ninguém.Para exemplificar na prática: Se definirmos um limite de 2 atendimentos por vendedor, o sistema só deverá encaminhar um novo atendimento para aquele vendedor quando ele tiver menos de 2 conversas ativas. Supondo que existam 4 vendedores disponíveis (Ana, Bruno, Carla e Daniel), e todos estejam abaixo do limite configurado, o sistema faria a distribuição de forma sequencial ou balanceada, por exemplo: 1º atendimento → Ana 2º atendimento → Bruno 3º atendimento → Carla 4º atendimento → Daniel

251
Rafael_Figueiredo
Blipper
Mateus Cruz
Mateus CruzConnected
postado em Builder e APIs
Erro ao criar ticket para um agente

Olá, estou utilizando a API da BLIP para transferir o contato para o BOT de transbordo e em seguida altero o stateid para o bloco de atendimento humano, por fim eu preciso criar um ticket para um agente, estou utilizando esse endpoint https://docs.blip.ai/?http#assign-a-ticket-to-an-agent, o problema em questão é que ao criar o ticket com a chave de API do BOT principal da erro com o código 67 e descrição “There is no configuration available for the specified identity”, e ao criar o ticket com a chave de API do bot de transbordo também dá erro, porém com a descrição “Could not find customer for the informed customer identity in this owner.”, estou fazendo a requisição com esse body:{ "id": "{{$guid}}", "to": "[email protected]", "method": "set", "uri": "/tickets", "type": "application/vnd.iris.ticket+json", "resource": { "customerIdentity": "[email protected]", "agentIdentity": "mateus.cruz%[email protected]", "team": "Default" }}Alguém sabe o que pode ser

2109
Mateus Cruz
T
TallesNew Member
perguntado em Builder e APIs
Iniciar conversa no bot automaticamente

Boa tarde pessoal, tudo bem?Tenho uma welcome page para o Blip Chat e quando o usuário clicar no botão de Iniciar Atendimento quero enviar uma mensagem para que o fluxo comece a rodar sem que ele precise fazer uma nova interação (sem precisar clicar em outro botao de iniciar atendimento dentro do chat)Minha primeira tentativa sem sucesso:POST https://{{contractId}}.http.msging.net/messagesBody:{"id": "{{$randomUUID}}","from": "{{userIdentity}}/{{routerId}}","to": "{{routerId}}@msging.net","type": "text/plain","content": "Iniciar atendimento"}Reponse 202Ao chamar o threads para entender o erro:{                "id": "f48e60ee-09e5-4ff3-8340-955cfd664429",                "direction": "received",                "type": "text/plain",                "content": "Iniciar atendimento",                "date": "2025-04-04T16:32:27.204Z",                "status": "failed",                "reason": {                    "code": 26,                    "description": "The 'pp' property must be specif

262
T
Leonardo Silva
Leonardo SilvaConnected
postado em Builder e APIs
Utilização de função da biblioteca dentro de um script V2

Olá, Andei olhando essa atualização da Blip a biblioteca de funções e achei algo fantástico, mas estou encontrando problemas no “como” utilizar a função. Eu li dois artigos e nenhum deles foi esclarecedor de fato:Esse aqui ele mostra que dá pra usar a função dentro do “Executar Script 2”, mas não dá maiores explicações.E nesse artigo ele mostra como usar apenas através da ação “Funções da Biblioteca”.Para exemplificar a questão, imagine que eu tenho uma função chamada soma com esse conteúdo e que espera dois parâmetros.function run(numero, numero2){ return numero + numero2;}Como eu posso fazer pra chamar ela dentro de um “Executar Script 2.0” passando os parâmetros necessários? Ou não é possível? Qual desses seria o correto ou nenhum deles é o correto? rsrsfunction run() { // Assim? const tentativa1 = blipfunction.soma(1,2); return tentativa1; // Ou assim? const tentativa2 = {{blipfunction.soma(1,2)}}; return tentativa2; // Ou ainda assim, como se fosse com eval {{blipfunction.soma}}

351
Marina Dias
Blipper | Community Manager
G
Gabriel FeitosaConnected
perguntado em Builder e APIs
COMO SALVAR DADOS ENVIADOS PELOS CLIENTES EM CERTA PARTE DO FLUXO?

Olá caros,  Em meu fluxo existe um bloco onde os clientes (motoristas) podem entrar em contato para vagas disponíveis, porém, no momento não temos mais vagas (pouca demanda), será que é possível, de alguma forma, salvar os currículos que os motoristas enviam nesse bloco do fluxo? Se possível, como consigo realizar tal feito? Grato,

252
Lucas Ventura
Neto
NetoConnected
perguntado em Builder e APIs
Redirecionar para a fila correta após consultar CPF na API.

Boa tarde, pessoal!Preciso de ajuda para direcionar um cliente para a fila correta com base na consulta do CPF na minha API.A lógica da consulta já está implementada e retorna os dados corretamente. Minha dúvida é: após localizar o CPF e identificar a unidade correspondente no cadastro, como faço para encaminhar o cliente para a fila correta de atendimento?Exemplo: O cliente João informa o CPF 123.456.789-10. Meu bot consulta esse CPF na API, encontra o cadastro e verifica que ele pertence à unidade de São Paulo. Com essa informação, qual seria a melhor forma de encaminhá-lo automaticamente para a fila de atendimento dessa unidade?Desde já, agradeço pela ajuda!

281
Lucas Ventura
Carlos F F Gonçalves
Carlos F F GonçalvesConnected
perguntado em Builder e APIs
API para buscar detalhes de um bloco

Boa tarde,Por vezes precisamos identificar onde e se o usuário está no fluxo do bot, para isso usamos o state-id nas variáveis de contexto, porém nessa variável é apresentado o id do bloco, hoje para conseguir identificar o bloco é necessário baixar o fluxo e identificar dentro do json do fluxo o nome do bloco correspondente ao id.A minha pergunta é se não teria uma api onde podemos através do id do bloco retornar informações como nome etc, seria bem útil. Se não há, fica a sugestão para disponibilização. Carlos

273
Lucas Ventura
Fabiano Mello
Fabiano MelloConnected
perguntado em Builder e APIs
Como habilitar o recebimento e salvar vídeos recebidos na conversa com o cliente.

Tenho um fluxo que precisa receber vídeos do cliente e salvar via api ou outra integração para salvar os vídeos no banco de dados ou drive, como fazer?

462
Fabiano Mello
Neto
NetoConnected
perguntado em Builder e APIs
Preenchimento Obrigatório de Dados do Cliente

Bom dia, pessoal! Tudo certo?Existe alguma forma de obrigar o atendente a preencher o campo CPF nos Dados do Contato antes de encerrar o atendimento?Cenário: No meu chatbot, há uma configuração padrão para clientes sem instrução, na qual eles são encaminhados diretamente para o atendimento humano, sem a necessidade de preencher o CPF. No entanto, quando o atendente não realiza esse preenchimento, o atendimento não migra para o nosso sistema.Gostaria de implementar uma solução dentro do Builder (ou externamente) que garantisse que o atendente preencha o CPF antes de finalizar o atendimento. Caso contrário, o atendimento permaneceria com ele e não poderia ser encerrado.Alguém já enfrentou esse problema ou tem sugestões de como resolver?

303
Lucas Ventura
guilhermeeneto
guilhermeenetoNew Member
perguntado em Builder e APIs
Problema com envio de template + redirecionamento para fluxo definido

Olá, pessoal!Estou enfrentando um problema ao enviar um template que, além de disparar a mensagem, deveria redirecionar o atendimento para um fluxo definido. No meu cenário, utilizo o envio de template via API, logo em seguida, realizo o redirecionamento para um fluxo específico usando o comando de alteração de fluxo. Fluxo desejado: envio de template + redirecionamento de atendimento para fluxo definidoComportamento esperado: que o usuário receba a mensagem/template e seja direcionado para o fluxo configurado no Blip. (atendimento Humano)

241
Lucas Ventura
joaotelles
joaotellesConnected
perguntado em Builder e APIs
Erro configuração HTTP Chave SDK

Estou tentando configurar o recebimento de dados do chat bot em outra ferramenta. Configurei as urls de envio e autenticação junto com as credencias, porém nao está sendo possível salvar essas informações na configuração do chatbot, pois ele me obriga a utilizar uma chave SDK. Olhei a documentação oficial e não diz nada referente a isso. Alguém poderia me auxiliar?   

181
Pericles_Feltrin
Blipper
GabrielRpZ
GabrielRpZConnected
postado em Builder e APIs
A GENTE IA

Opa, gostaria de saber se é possível usar o Ia Agente para direcionar para o chat bot ou para algum serviço dentro do chat bot, deixando assim o Ia Agente como ferramenta principal de comunicação e usando ela para guiar e direcionar o usuário para serviços específicos.

322
Marina Dias
Blipper | Community Manager
H
Hugo AvellInspiring
perguntado em Builder e APIs
Datas dados API histórico de atendimentos

Pessoal, eu uso a API para coletar dados do histórico de atendimentos. Mais especificamente uso a extensão desk. Recentemente percebi que tem um limite de datas, no qual consigo resposta dessa API. Qual o intervalo de tempo  eu consigo dados pela API?Como faço para conseguir dados anteriores??

374
H

Termos de Uso e PrivacidadeDefinições de cookies