BoomApp Connect [en]
2-vias, e-mail, voz, SMS e mensagens push globais "inteligentes". Melhore todas as aplicações da Power Platform com o boomapp connect para criar fluxos de trabalho de comunicações conversacionais multicanal verdadeiramente automatizados (exclusivamente orientados pelo assunto). Fluxos de trabalho de comunicação totalmente interativos com base na resposta de um destinatário permitem a entrega de interações contínuas e sem atrito sem forçar mudanças comportamentais através do engajamento. Para mais detalhes e para configurar uma conta de avaliação gratuita, consulte o nosso site.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure China |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - China Cloud operado pela 21Vianet |
| Contato | |
|---|---|
| Nome | Suporte Boomerang |
| URL | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| support@boomcomms.com |
| Metadados do conector | |
|---|---|
| Editora | Bumerangue I-Comms Ltd |
| Sítio Web | https://www.boomerangmessaging.com/products/boomApp/msconnector |
| Política de privacidade | https://boomerangmessaging.com/privacy/ |
| Categorias | Comunicação; Produtividade |
Pre-requisites
Você precisará do seguinte para prosseguir:
- Um plano Microsoft Power Automate com recurso de conector personalizado
- Uma assinatura Boomerang
- Detalhes de autenticação da API Boomerang.
Crie uma conta com o Boomerang
- website - Mais detalhes sobre como criar contas Boomerang.
Suporte e documentação:
Pode encontrar a documentação aqui.
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | 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.
Esta conexão não é compartilhável. Se o aplicativo avançado 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 utilizador | securestring | O nome de usuário para esta api | Verdade |
| palavra-passe | securestring | A senha para esta api | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
|
Envie mensagens de e-mail únicas ou em massa. Os e-mails são enviados a partir do domínio @boomerangui.com e é possível personalizar o Assunto e substituir o endereço "De". Também é possível encaminhar respostas para um endereço de e-mail e / ou um 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 Bumerangue podem usar um número associado a uma Campanha, o que permite que as respostas recebidas sejam acessadas a partir da seção Relatórios de campanha na interface do usuário do Boomerang. No entanto, ao contrário do método SMS 2-way, as respostas não são rastreadas em relação à mensagem de saída. Consulte https://boomerangmessaging.com/docs/sending-sms-messages para obter mais informações. |
| SMS bidirecional |
Esse método permite que as respostas sejam rastreadas diretamente em relação a cada transação de saída e é usado para gerenciar conversas entre seu sistema e o usuário final. As respostas podem ser encaminhadas para um endereço de e-mail e os clientes com o Boommail podem enviar uma mensagem de e-mail 2-SMS de volta para o respondente. Consulte https://boomerangmessaging.com/docs/sending-sms-messages, para obter mais informações sobre mensagens de 2 vias e conversacionais. |
| SMS unidirecional |
As mensagens SMS são entregues usando um originador alfanumérico (como o nome de uma empresa), que deve conter no máximo 11 caracteres, e um destinatário não pode responder a uma mensagem enviada usando um originador alfanumérico. Observe também que em destinos onde a entrega de mensagens com originador alfanumérico não é suportada (devido a restrições locais), isso pode ser substituído por um originador numérico, para garantir que a mensagem seja entregue. |
| Voice |
Um número fixo é usado como originador de uma chamada de voz TTS (Text-To-Speech). As teclas '1' e '2' são usadas para aceitar ou recusar a mensagem, '9' é usado para redirecionar a chamada. Consulte https://boomerangmessaging.com/docs/sending-delivering-voice-messages para obter mais informações |
Envie mensagens de e-mail únicas ou em massa. Os e-mails são enviados a partir do domínio @boomerangui.com e é possível personalizar o Assunto e substituir o endereço "De". Também é possível encaminhar respostas para um endereço de e-mail e / ou um URL
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
de
|
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 e-mail é recebido na caixa de entrada do destinatário |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada para todos os recipientAddresses. |
|
|
email_address
|
email_address | array of string |
email_address |
|
|
validity_period
|
validity_period | integer |
O período de tempo durante o qual o número usado para enviar a mensagem estará ativo. As respostas à mensagem não serão entregues após o termo do período de validade. 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 ticket, o que significa que a mensagem é fechada no recebimento da primeira resposta. Para corresponder várias respostas à mesma mensagem de origem, use o ticket aberto passando true. |
|
|
email_responses
|
email_responses | string |
Um endereço de e-mail para o qual as respostas das mensagens são encaminhadas. |
|
|
push_responses
|
push_responses | string |
Um URL de retorno de chamada para o qual as respostas da mensagem são publicadas. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador único para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará quaisquer transações com um Id que tenha sido usado 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 uma referência de campanha, referência de trabalho, ID de lote, etc. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
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 Bumerangue podem usar um número associado a uma Campanha, o que permite que as respostas recebidas sejam acessadas a partir da seção Relatórios de campanha na interface do usuário do Boomerang. No entanto, ao contrário do método SMS 2-way, as respostas não são rastreadas em relação à mensagem de saída. Consulte https://boomerangmessaging.com/docs/sending-sms-messages para obter mais informações.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
de
|
from | string |
O ID de envio associado 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 para todos os recipientAddresses. |
|
|
Endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telemóvel que deve conter um mínimo de 11 algarismos (excluindo + ou «0» à esquerda) e um máximo de 16 algarismos (excluindo um + quando este é utilizado como prefixaçã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 as 'Horas Sociais' configuradas em relação a uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador único para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará quaisquer transações com um Id que tenha sido usado 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 uma referência de campanha, referência de trabalho, ID de lote, etc. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
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 rastreadas diretamente em relação a cada transação de saída e é usado para gerenciar conversas entre seu sistema e o usuário final. As respostas podem ser encaminhadas para um endereço de e-mail e os clientes com o Boommail podem enviar uma mensagem de e-mail 2-SMS de volta para o respondente. Consulte https://boomerangmessaging.com/docs/sending-sms-messages, para obter mais informações sobre mensagens de 2 vias e conversacionais.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
conversation_id
|
conversation_id | string |
Definir um ID de conversação para agrupar todas as mensagens (incluindo respostas) que fazem parte da mesma conversação |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada para todos os recipientAddresses. |
|
|
Endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telemóvel que deve conter um mínimo de 11 algarismos (excluindo + ou «0» à esquerda) e um máximo de 16 algarismos (excluindo um + quando este é utilizado como prefixaçã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 de tempo durante o qual o número usado para enviar a mensagem estará ativo. As respostas à mensagem não serão entregues após o termo do período de validade. 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 ticket, o que significa que a mensagem é fechada no recebimento da primeira resposta. Para corresponder várias respostas à mesma mensagem de origem, use o ticket aberto passando true. |
|
|
email_responses
|
email_responses | string |
Um endereço de e-mail para o qual as respostas das mensagens são encaminhadas. |
|
|
push_responses
|
push_responses | string |
Um URL de retorno de chamada para o qual as respostas da mensagem são publicadas. |
|
|
priority
|
priority | boolean |
Parâmetro opcional usado para definir um status de prioridade para uma mensagem. Todas as mensagens enviadas com 'prioridade' substituirão as 'Horas Sociais' configuradas em relação a uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador único para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará quaisquer transações com um Id que tenha sido usado 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 uma referência de campanha, referência de trabalho, ID de lote, etc. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
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 o nome de uma empresa), que deve conter no máximo 11 caracteres, e um destinatário não pode responder a uma mensagem enviada usando um originador alfanumérico. Observe também que em destinos onde a entrega de mensagens com originador alfanumérico não é suportada (devido a restrições locais), isso pode ser substituído por um originador numérico, para garantir que a mensagem seja entregue.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
de
|
from | string |
ID de origem para uma mensagem de 1 via. Um valor alfanumérico contendo um máximo de 11 caracteres. |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada para todos os recipientAddresses. |
|
|
Endereço de destino do destinatário
|
number | string |
O endereço de destino do destinatário; Um número de telemóvel que deve conter um mínimo de 11 algarismos (excluindo + ou «0» à esquerda) e um máximo de 16 algarismos (excluindo um + quando este é utilizado como prefixaçã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 as 'Horas Sociais' configuradas em relação a uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador único para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará quaisquer transações com um Id que tenha sido usado 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 uma referência de campanha, referência de trabalho, ID de lote, etc. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
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 |
Voice
Um número fixo é usado como originador de uma chamada de voz TTS (Text-To-Speech). As teclas '1' e '2' são usadas para aceitar ou recusar a mensagem, '9' é usado para redirecionar a chamada. Consulte https://boomerangmessaging.com/docs/sending-delivering-voice-messages para obter mais informações
Parâmetros
| Name | Chave | Necessá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 a seguir. |
|
|
voice_thank_you
|
voice_thank_you | string |
A mensagem reproduzida no final da chamada de voz após a reprodução do conteúdo da mensagem. |
|
|
voice_redirect_message
|
voice_redirect_message | string |
A mensagem reproduzida no final da chamada de voz após a reprodução do conteúdo da mensagem. |
|
|
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 aguardado pelo sistema entre as tentativas. |
|
|
message_content
|
message_content | string |
O conteúdo da mensagem de saída enviada para todos os recipientAddresses. |
|
|
número
|
number | string |
O endereço de destino do destinatário; Um número de telemóvel que deve conter um mínimo de 11 algarismos (excluindo + ou «0» à esquerda) e um máximo de 16 algarismos (excluindo um + quando este é utilizado como prefixaçã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 as 'Horas Sociais' configuradas em relação a uma conta. Passe true para definir prioridade. |
|
|
unique_identifier
|
unique_identifier | string |
Identificador único para cada transação. Isso é usado para proteger contra a duplicação de mensagens, pois o Boomerang ignorará quaisquer transações com um Id que tenha sido usado 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 uma referência de campanha, referência de trabalho, ID de lote, etc. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
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 |
Acionadores
| Na entrega confirmada |
Acionado pela atualização do 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. Consulte https://boomerangmessaging.com/docs para obter mais informações |
| Sobre o envio de resposta por SMS |
Acionado por respostas de entrada que são automaticamente mapeadas para as mensagens de saída associadas quando enviadas como uma mensagem inteligente de 2 vias / conversação |
Na entrega confirmada
Acionado pela atualização do 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. Consulte https://boomerangmessaging.com/docs para obter mais informações
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
mensagem
|
message | string |
mensagem |
|
tem_mais
|
has_more | boolean |
tem_mais |
|
DRS
|
drs | array of object |
DRS |
|
transaction_id
|
drs.transaction_id | string |
transaction_id |
|
estado
|
drs.status | string |
estado |
|
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 |
Sobre o envio de resposta por SMS
Acionado por respostas de entrada que são automaticamente mapeadas para as mensagens de saída associadas quando enviadas como uma mensagem inteligente de 2 vias / conversação
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer |
estado |
|
mensagem
|
message | string |
mensagem |
|
tem_mais
|
has_more | boolean |
tem_mais |
|
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 |
|
de
|
replies.from | string |
de |
|
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 |