conexão boomapp
"Inteligente" global de 2 vias, Email, Voz, SMS e Mensagens por Push. Sobrecarregar todos os aplicativos do Power Platform com o boomapp connect para criar fluxos de trabalho de comunicação de conversação multicanais verdadeiramente automatizados (exclusivamente controlados pelo assunto). Fluxos de trabalho de comunicações totalmente interativos com base na resposta de um destinatário permitem a entrega de interações perfeitas e sem atritos sem forçar mudanças comportamentais por meio do envolvimento. Para obter mais detalhes e configurar uma conta de avaliação gratuita, consulte nosso site.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: - Regiões do Azure China |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Suporte ao Boomerang |
| URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| support@boomcomms.com |
| Metadados do conector | |
|---|---|
| Publicador | Boomerang I-Comms Ltd |
| Site | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| Política de privacidade | https://boomerangmessaging.com/privacy/ |
| Categorias | Comunicação; Produtividade |
Pré-requisitos
Você precisará do seguinte para continuar:
- Um plano do Microsoft Power Automate com o recurso de conector personalizado
- Uma assinatura do Boomerang
- Detalhes da autenticação da API do Boomerang.
Criar uma conta com o Boomerang
- site – mais detalhes sobre como criar contas do Boomerang.
Suporte e documentação:
Você pode encontrar a documentação aqui.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| nome de usuário | secureString | O nome de usuário para esta api | Verdade |
| senha | secureString | A senha dessa api | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
|
Enviar mensagens de email simples ou em massa. Emails são enviados do domínio @boomerangui.com e é possível personalizar o Assunto e substituir o endereço 'From'. Também é possível encaminhar respostas para um endereço de email e/ou uma URL |
|
| Número personalizado de SMS |
As mensagens SMS são entregues usando o número especificado na solicitação para que todas as respostas sejam retornadas para esse número. Os clientes que usam o recurso Campanha do Boomerang podem usar um número associado a uma Campanha, que permite que as respostas de entrada sejam acessadas na seção relatório de campanha na interface do usuário do Boomerang. No entanto, ao contrário do método sms de duas vias, as respostas não são controladas na mensagem de saída. Consulte https://boomerangmessaging.com/docs/sending-sms-messages para obter mais informações. |
| Serviço de Voz |
Um número fixo é usado como o originador de uma chamada de voz TTS (Text-To-Speech). Os pressionamentos de tecla '1' e '2' são usados para aceitar ou recusar a mensagem, '9' é usado para redirecionar a chamada. Confira https://boomerangmessaging.com/docs/sending-delivering-voice-messages mais informações |
| Sms bidirecional |
Esse método permite que as respostas sejam controladas diretamente em cada transação de saída e são usadas para gerenciar conversas entre seu sistema e o usuário final. As respostas podem ser encaminhadas para um endereço de email e os clientes com o Boommail podem enviar uma mensagem de email 2-SMS de volta para o respondente. Consulte https://boomerangmessaging.com/docs/sending-sms-messages, para obter mais informações sobre mensagens bidirecionais e de conversa. |
| Sms unidirecional |
As mensagens SMS são entregues usando um originador alfanumérico (como um nome da empresa) que deve conter no máximo 11 caracteres, e um destinatário não pode responder a uma mensagem enviada usando um originador numérico alfa. Observe também que em destinos em que não há suporte para a entrega de mensagens com o originador alfanumérico (devido a restrições locais), isso pode ser substituído por um originador numérico, para garantir que a mensagem seja entregue. |
Enviar mensagens de email simples ou em massa. Emails são enviados do domínio @boomerangui.com e é possível personalizar o Assunto e substituir o endereço 'From'. Também é possível encaminhar respostas para um endereço de email e/ou uma URL
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
from
|
from | string |
Passe o conteúdo a ser usado como o endereço De. Se estiver em branco, o valor padrão será retirado das configurações da sua conta |
|
|
email_subject
|
email_subject | string |
Sujeito a ser exibido por padrão quando o email é recebido na caixa de entrada do destinatário |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada a todos os recipientAddresses. |
|
|
email_address
|
email_address | array of string |
email_address |
|
|
validity_period
|
validity_period | integer |
O período durante o qual o número usado para enviar a mensagem estará ativo. As respostas à mensagem não serão entregues após o período de validade expirar. Para mensagens bidirecionais, o período mínimo de validade é de 1 dia. |
|
|
open_ticket
|
open_ticket | boolean |
Por padrão, todas as mensagens são enviadas um único tíquete, o que significa que a mensagem é fechada no recebimento da primeira resposta. Para corresponder várias respostas à mesma mensagem de origem, use o tíquete aberto passando true. |
|
|
email_responses
|
email_responses | string |
Um endereço de email para o qual as respostas da mensagem são encaminhadas. |
|
|
push_responses
|
push_responses | string |
Uma URL de Retorno de Chamada na qual as respostas da mensagem são postadas. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador exclusivo para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará todas as transações com uma ID que tenha sido usada anteriormente. |
|
|
campaign_name
|
campaign_name | string |
Identificador opcional que pode ser usado para agrupar mensagens por campanhas específicas e mensagens em lote. |
|
|
custom_parameter
|
custom_parameter | string |
Parâmetro usado para referência personalizada. Isso pode ser usado, por exemplo, como referência de campanha, referência de trabalho, ID do lote etc. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
transações
|
transactions | array of object |
transações |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
email_address
|
transactions.email_address | string |
email_address |
Número personalizado de SMS
As mensagens SMS são entregues usando o número especificado na solicitação para que todas as respostas sejam retornadas para esse número. Os clientes que usam o recurso Campanha do Boomerang podem usar um número associado a uma Campanha, que permite que as respostas de entrada sejam acessadas na seção relatório de campanha na interface do usuário do Boomerang. No entanto, ao contrário do método sms de duas vias, as respostas não são controladas na mensagem de saída. Consulte https://boomerangmessaging.com/docs/sending-sms-messages para obter mais informações.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
from
|
from | string |
A ID de envio associada a uma mensagem pode ser um número de campanha de entrada atualmente associado a uma campanha ativa. |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada a todos os recipientAddresses. |
|
|
O endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telefone celular que deve conter um mínimo de 11 dígitos (excluindo + ou liderando '0') e um máximo de 16 dígitos (excluindo um + em que isso é usado como uma pré-correção para o próprio número). Um único número ou uma matriz de até 10.000 números pode ser passado. |
|
|
priority
|
priority | boolean |
Parâmetro opcional usado para definir um status de prioridade para uma mensagem. Todas as mensagens enviadas com 'prioridade' substituirão 'Horas Sociais' configuradas em uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador exclusivo para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará todas as transações com uma ID que tenha sido usada anteriormente. |
|
|
campaign_name
|
campaign_name | string |
Identificador opcional que pode ser usado para agrupar mensagens por campanhas específicas e mensagens em lote. |
|
|
custom_parameter
|
custom_parameter | string |
Parâmetro usado para referência personalizada. Isso pode ser usado, por exemplo, como referência de campanha, referência de trabalho, ID do lote etc. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
transações
|
transactions | array of object |
transações |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Serviço de Voz
Um número fixo é usado como o originador de uma chamada de voz TTS (Text-To-Speech). Os pressionamentos de tecla '1' e '2' são usados para aceitar ou recusar a mensagem, '9' é usado para redirecionar a chamada. Confira https://boomerangmessaging.com/docs/sending-delivering-voice-messages mais informações
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
voice_intro
|
voice_intro | string |
A mensagem reproduzida quando a chamada de voz é atendida. O conteúdo da mensagem será reproduzido logo após ele. |
|
|
voice_thank_you
|
voice_thank_you | string |
A mensagem foi reproduzida no final da chamada de voz depois que o conteúdo da mensagem foi reproduzido. |
|
|
voice_redirect_message
|
voice_redirect_message | string |
A mensagem foi reproduzida no final da chamada de voz depois que o conteúdo da mensagem foi reproduzido. |
|
|
número
|
number | string |
Número de redirecionamento |
|
|
voice_retries
|
voice_retries | integer |
Número de tentativas feitas se a chamada de voz não for atendida na primeira vez. |
|
|
voice_delay
|
voice_delay | integer |
Tempo esperado pelo sistema entre novas tentativas. |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada a todos os recipientAddresses. |
|
|
número
|
number | string |
O endereço de destino do destinatário; Um número de telefone celular que deve conter um mínimo de 11 dígitos (excluindo + ou liderando '0') e um máximo de 16 dígitos (excluindo um + em que isso é usado como uma pré-correção para o próprio número). Um único número ou uma matriz de até 10.000 números pode ser passado. |
|
|
priority
|
priority | boolean |
Parâmetro opcional usado para definir um status de prioridade para uma mensagem. Todas as mensagens enviadas com 'prioridade' substituirão 'Horas Sociais' configuradas em uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador exclusivo para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará todas as transações com uma ID que tenha sido usada anteriormente. |
|
|
campaign_name
|
campaign_name | string |
Identificador opcional que pode ser usado para agrupar mensagens por campanhas específicas e mensagens em lote. |
|
|
custom_parameter
|
custom_parameter | string |
Parâmetro usado para referência personalizada. Isso pode ser usado, por exemplo, como referência de campanha, referência de trabalho, ID do lote etc. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
transações
|
transactions | array of object |
transações |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Sms bidirecional
Esse método permite que as respostas sejam controladas diretamente em cada transação de saída e são usadas para gerenciar conversas entre seu sistema e o usuário final. As respostas podem ser encaminhadas para um endereço de email e os clientes com o Boommail podem enviar uma mensagem de email 2-SMS de volta para o respondente. Consulte https://boomerangmessaging.com/docs/sending-sms-messages, para obter mais informações sobre mensagens bidirecionais e de conversa.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
Definir uma ID de conversa para agrupar todas as mensagens (incluindo respostas) parte da mesma conversa |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada a todos os recipientAddresses. |
|
|
O endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telefone celular que deve conter um mínimo de 11 dígitos (excluindo + ou liderando '0') e um máximo de 16 dígitos (excluindo um + em que isso é usado como uma pré-correção para o próprio número). Um único número ou uma matriz de até 10.000 números pode ser passado. |
|
|
validity_period
|
validity_period | integer |
O período durante o qual o número usado para enviar a mensagem estará ativo. As respostas à mensagem não serão entregues após o período de validade expirar. Para mensagens bidirecionais, o período mínimo de validade é de 1 dia. |
|
|
open_ticket
|
open_ticket | boolean |
Por padrão, todas as mensagens são enviadas um único tíquete, o que significa que a mensagem é fechada no recebimento da primeira resposta. Para corresponder várias respostas à mesma mensagem de origem, use o tíquete aberto passando true. |
|
|
email_responses
|
email_responses | string |
Um endereço de email para o qual as respostas da mensagem são encaminhadas. |
|
|
push_responses
|
push_responses | string |
Uma URL de Retorno de Chamada na qual as respostas da mensagem são postadas. |
|
|
priority
|
priority | boolean |
Parâmetro opcional usado para definir um status de prioridade para uma mensagem. Todas as mensagens enviadas com 'prioridade' substituirão 'Horas Sociais' configuradas em uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador exclusivo para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará todas as transações com uma ID que tenha sido usada anteriormente. |
|
|
campaign_name
|
campaign_name | string |
Identificador opcional que pode ser usado para agrupar mensagens por campanhas específicas e mensagens em lote. |
|
|
custom_parameter
|
custom_parameter | string |
Parâmetro usado para referência personalizada. Isso pode ser usado, por exemplo, como referência de campanha, referência de trabalho, ID do lote etc. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
transações
|
transactions | array of object |
transações |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Sms unidirecional
As mensagens SMS são entregues usando um originador alfanumérico (como um nome da empresa) que deve conter no máximo 11 caracteres, e um destinatário não pode responder a uma mensagem enviada usando um originador numérico alfa. Observe também que em destinos em que não há suporte para a entrega de mensagens com o originador alfanumérico (devido a restrições locais), isso pode ser substituído por um originador numérico, para garantir que a mensagem seja entregue.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
from
|
from | string |
ID de origem para uma mensagem de 1 via. Um valor numérico alfa que contém um máximo de 11 caracteres. |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada a todos os recipientAddresses. |
|
|
O endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telefone celular que deve conter um mínimo de 11 dígitos (excluindo + ou liderando '0') e um máximo de 16 dígitos (excluindo um + em que isso é usado como uma pré-correção para o próprio número). Um único número ou uma matriz de até 10.000 números pode ser passado. |
|
|
priority
|
priority | boolean |
Parâmetro opcional usado para definir um status de prioridade para uma mensagem. Todas as mensagens enviadas com 'prioridade' substituirão 'Horas Sociais' configuradas em uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador exclusivo para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará todas as transações com uma ID que tenha sido usada anteriormente. |
|
|
campaign_name
|
campaign_name | string |
Identificador opcional que pode ser usado para agrupar mensagens por campanhas específicas e mensagens em lote. |
|
|
custom_parameter
|
custom_parameter | string |
Parâmetro usado para referência personalizada. Isso pode ser usado, por exemplo, como referência de campanha, referência de trabalho, ID do lote etc. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
transações
|
transactions | array of object |
transações |
|
transaction_id
|
transactions.transaction_id | string |
transaction_id |
|
parts_per_message
|
transactions.parts_per_message | integer |
parts_per_message |
|
telephone_number
|
transactions.telephone_number | string |
telephone_number |
Gatilhos
| Na entrega confirmada |
Disparado pela atualização de status de entrega do usuário final. Atualiza a transação com o status de entrega retornado pelo operador de rede do usuário final. Confira https://boomerangmessaging.com/docs mais informações |
| No envio de resposta por SMS |
Disparado por respostas de entrada que são mapeadas automaticamente para as mensagens de saída associadas quando enviadas como uma mensagem inteligente de 2 vias/conversação |
Na entrega confirmada
Disparado pela atualização de status de entrega do usuário final. Atualiza a transação com o status de entrega retornado pelo operador de rede do usuário final. Confira https://boomerangmessaging.com/docs mais informações
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
has_more
|
has_more | boolean |
has_more |
|
Drs
|
drs | array of object |
Drs |
|
transaction_id
|
drs.transaction_id | string |
transaction_id |
|
status
|
drs.status | string |
status |
|
status_date
|
drs.status_date | string |
status_date |
|
destino
|
drs.destination | string |
destino |
|
custom_parameter
|
drs.custom_parameter | string |
custom_parameter |
|
campaign_name
|
drs.campaign_name | string |
campaign_name |
|
unique_id
|
drs.unique_id | string |
unique_id |
No envio de resposta por SMS
Disparado por respostas de entrada que são mapeadas automaticamente para as mensagens de saída associadas quando enviadas como uma mensagem inteligente de 2 vias/conversação
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
status
|
status | integer |
status |
|
mensagem
|
message | string |
mensagem |
|
has_more
|
has_more | boolean |
has_more |
|
respostas
|
replies | array of object |
respostas |
|
transaction_id
|
replies.transaction_id | string |
transaction_id |
|
custom_parameter
|
replies.custom_parameter | string |
custom_parameter |
|
response_id
|
replies.response_id | string |
response_id |
|
from
|
replies.from | string |
from |
|
response_content
|
replies.response_content | string |
response_content |
|
is_new
|
replies.is_new | boolean |
is_new |
|
transaction_date
|
replies.transaction_date | string |
transaction_date |
|
response_date
|
replies.response_date | string |
response_date |