Configurando a Integração da BV Telecom para Envio de SMS na URA do Tactium IP
Sumário
Objetivo
Este documento descreve o procedimento para integrar o IVR Manager com a BV Telecom para o envio de mensagens SMS por meio da API disponibilizada pelo provedor.
Pré-requisito
Antes de iniciar a configuração, certifique-se de possuir as seguintes informações fornecidas pela BV Telecom:
- API Key de autenticação.
- URL (endpoint) da API de integração para envio de SMS.
Cadastrando o link do WebServices.
Acesse Cadastro > Configurações > WebServices.
Cadastre um novo WebService utilizando a URL de integração fornecida pela BV Telecom.

Cadastrando a ação externa
Após cadastrar o WebService, crie uma Ação Externa e configure os parâmetros conforme os exemplos apresentados nas imagens de referência.
Configure os seguintes parâmetros de entrada:
| Parâmetro | Descrição |
|---|---|
| ApiKey | API Key fornecida pela BV Telecom. |
| bulk[0].celular | Número do telefone que receberá o SMS que é coletado pelo IVR, com o numero de A. |
| bulk[0].mensagem | Conteúdo da mensagem a ser enviada. |
| bulk[0].parceiroId | Identificador do parceiro fornecido pela BV Telecom ou pode ser um codigo aleatório, como por exemplo, o ID da ligação. |

Cadastrando as variáveis
Após configurar a Ação Externa, cadastre as variáveis necessárias conforme os exemplos apresentados nas imagens de referência. Essas variáveis serão utilizadas para enviar os parâmetros da requisição e, quando configurado, armazenar o retorno da API.

Parâmetros de saída (Opcional)
A configuração dos parâmetros de saída é opcional e deve ser realizada apenas caso exista a necessidade de tratar o retorno da API.
Podem ser criadas, por exemplo, as seguintes variáveis:
| Variável | Valor esperado | Descrição |
|---|---|---|
| error | True ou False |
Indica se ocorreu erro durante o envio do SMS. |
| message | "Message sent successfully" |
Mensagem retornada pela API quando o SMS é enviado com sucesso. |
Essas variáveis podem ser utilizadas no fluxo do IVR Manager para validações, tratamento de erros e definição das próximas ações da automação.
