--- title: Blip slug: blip docTags: createdAt: 2025-04-01T11:55:22.010Z --- ## Objetivo/Resumo O conector Blip tem como finalidade facilitar a integração entre a plataforma Blip e sistemas externos, permitindo a troca eficiente e segura de mensagens e dados. Ele possibilita a automação de comunicações, processamento de mensagens em tempo real e integração com diversas APIs, tornando-se uma solução versátil para empresas que necessitam de comunicação automatizada e centralizada. A solução é ideal para cenários como atendimento ao cliente, notificações automatizadas, processamento de dados e interação com diferentes canais de mensagens. Com o conector Blip, é possível otimizar fluxos de trabalho e aprimorar a experiência do usuário em diversos contextos empresariais. ## Criando uma conexão Antes de usar o conector Blip, é necessária a criação de uma conexão. Vamos lá. - Clique em Propriedades. - Em Selecionar uma conexão clique em Criar nova conexão. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/kBmE5brcL2r0zz2FzXH6B_image.png" size="50" width="800" height="776" position="center" darkWidth="800" darkHeight="776" showCaption="false"} - Preencha os dados da conexão. - Com os dados da conexão preenchidos, clique em Salvar conexão. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/yPNTcgxJA8AynGMwbuCx6_image-1.png" size="50" width="765" height="596" position="center" darkWidth="765" darkHeight="596" showCaption="false"} Agora você já pode montar seus fluxos utilizando o Conector Blip. ## Como utilizar o Conector Blip Exemplo prático: fazendo um disparo para o chat do WhatsApp. - Utilizando `{{ uuidv4 }}` você pode gera um UUID V4 por execução. - IInforme o número do contato com DDI (55 para Brasil), seguido do DDD e do número do telefone. ::Image[]{src="https://api.archbee.com/api/optimize/G1NTw6yAi4RDUYbsU8csp/GPi8GldWyXNzKsgCjZLfO_image-2.png" size="50" width="419" height="442" position="center" darkWidth="419" darkHeight="442" showCaption="false"} - Configure o passo que envia a mensagem usando as informações do passo que busca o identificador. - Utilize novamente o UUID. - No campo identificador, busque dinamicamente o valor retornado pelo primeiro passo. - No campo nome do template, informe um template que já esteja aprovado. - No campo extra, informe a mesma quantidade de argumentos existente no template utilizado. Feitas as configurações corretas, basta executar o fluxo e validar se a mensagem foi recebida no WhatsApp informado. ### Outras operações disponíveis - Buscar identificador - Criar contato - Lista contato - Enviar mensagem ativa (campanha) - Retornar mensagens do contato - Estado principal - Alterar estado do usuário - Criar métricas :::hint{type="warning"} A operação **Enviar mensagem** foi descontinuada. ::: ### Buscar identificador Permite buscar o identificador de um contato a partir do número de telefone do WhatsApp. Para utilizar essa operação, informe: - **UUID:** é necessário informar um UUID. - **Número WhatsApp:** informe o número do contato WhatsApp. ### Lista contato Permite consultar a lista de contatos. Para utilizar essa operação, informe: - **UUID:** é necessário informar um UUID. - **Skip:** informe o número de entidades a serem ignoradas. - **Take:** informe o número de entidades a serem retornadas. ### Enviar mensagem ativa (campanha) Permite realizar o disparo de uma mensagem ativa via campanha. Para utilizar essa operação, informe: - **UUID:** é necessário informar um UUID. - **Nome da campanha:** informe o nome que identifica a campanha nos relatórios da Blip. - **Número do destinatário:** informe o número do destinatário com DDI e DDD. O prefixo `+` será adicionado automaticamente caso não seja informado. - **Nome do template:** informe o nome do template de mensagem aprovado na Meta. Os campos abaixo são opcionais: - **Idioma do template:** o padrão é `pt-BR`. Deve ser informado quando o template estiver em outro idioma. - **Variáveis do template:** informe uma chave e um valor para cada variável do template. A quantidade deve ser exatamente igual à quantidade de variáveis do template. - **Variáveis de contexto:** permite informar valores que serão gravados no contexto do contato e poderão ser acessados no fluxo através de `{{context.nomeDaVariavel}}`. - **ID do Fluxo:** fluxo para onde o contato será direcionado ao responder a mensagem. - **ID do Estado:** bloco do fluxo para onde o contato será direcionado ao responder a mensagem. - **ID do BOT (master state):** utilizado em arquiteturas de router para posicionar o contato no sub-bot correto. - **Origem do disparo:** identifica a origem da campanha nos relatórios. O padrão é `Fluid`. - **Agendamento:** permite definir a data e hora do disparo. Caso não seja informado, o disparo será imediato. - **Tags da campanha:** permite adicionar tags para agrupar campanhas nos relatórios. Para as variáveis do template, utilize a posição da variável (`1`, `2`, `3` etc.) para templates com variáveis numéricas, ou o nome da variável para templates nomeados. Para variáveis de imagem, vídeo ou botão de URL dinâmica, informe a URL no campo **Valor**. ### Retornar mensagens do contato Permite retornar as mensagens relacionadas a um determinado contato. Para utilizar essa operação, informe: - **UUID:** é necessário informar um UUID. - **Número do contato:** informe o identificador do contato WhatsApp. ## Dicas e considerações 1. Certifique-se de que a key de acesso Blip esteja correta. 2. Sempre teste o fluxo antes de colocá-lo em produção. ## Conclusão O conector Blip é uma ferramenta poderosa para automatizar notificações em integrações complexas. Com ele, você pode criar fluxos que automatizam o envio de mensagens de forma **segura**, **eficiente** e **personalizável**.