Sinch (versão prévia)
O Sinch ajuda sua empresa a se conectar aos clientes por meio de alertas, lembretes, convites, campanhas de marketing e muito mais. Alimentados por Sinch Engage, Sinch MessageMedia, One NZ, eTXT e GroupText, nossas plataformas fornecem bilhões de mensagens globalmente. Com esse conector, você pode integrar facilmente SMS, RCS e MMS em seus fluxos de trabalho, simplificando e automatizando as comunicações do cliente.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Azure regiões da China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Canal de suporte |
| URL | https://messagemedia.com/contact/ |
| support@messagemedia.com |
| Metadados do conector | |
|---|---|
| Publisher | Sinch Suécia AB |
| Site | https://messagemedia.com |
| Política de privacidade | https://messagemedia.com/legal/privacy-policy/ |
| Categorias | Communication |
Seu nome do conector
Sinch
Documentação da API
https://messagemedia.github.io/documentation/#tag/Messages/operation/SendMessages
Operações com suporte
https://support.messagemedia.com/hc/en-us/categories/10710547404559-Power-Automate-App-Support
Como obter credenciais
Esse conector usa e API Key autenticação (consulte as etapas API secret no link abaixo sobre como obter um)https://support.messagemedia.com/hc/en-us/articles/4413627066383-Creating-New-API-Credentials
Operações com suporte
Esse conector dá suporte às seguintes operações:
-
Send Text Message (SMS): envie uma mensagem de texto (SMS) para vários destinatários móveis. -
Send Rich Text Message (RCS): envie uma mensagem RCS para um destinatário móvel. -
Send MMS Message (MMS): envie uma mensagem multimídia (MMS) para vários destinatários móveis. -
Get sender IDs: obtenha uma lista de IDs do Remetente vinculadas à sua conta. -
Get message status: obtenha um status de mensagem usando uma ID de mensagem. -
When a message is received: essa operação é disparada quando você recebe uma mensagem de entrada (SMS, RCS, MMS). -
When delivery receipt is received: essa operação é disparada quando você recebe uma confirmação de entrega para uma mensagem de saída (SMS, RCS, MMS).
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 |
|---|---|---|---|
| chave_de_api | secureString | O api_key desta api | Verdade |
| api_secret | secureString | O api_secret desta api | Verdade |
| Serviços do Sinch | cadeia | Esta é a API à qual está sendo conectada, escolha uma das seguintes opções: Sinch MessageMedia (melhor para contas específicas da Ásia); Sinch engage (Best for Europe, US accounts) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Enviar Mensagem de Texto (SMS) |
Envie uma mensagem de texto (SMS) para vários destinatários móveis. |
| Enviar mensagem MMS |
Essa ação é usada para enviar uma mensagem multimídia (MMS) para um número de celular. |
| Enviar RCS (Mensagem de Rich Text) |
Enviar mensagem RCS para um destinatário móvel. |
| Obter IDs do remetente |
Obtenha uma lista de IDs do Remetente vinculadas à sua conta. |
| Obter o status da mensagem |
Obtenha um status de mensagem usando uma ID de mensagem. |
Enviar Mensagem de Texto (SMS)
Envie uma mensagem de texto (SMS) para vários destinatários móveis.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do remetente
|
source_number | string |
Especificar um número de origem a ser usado |
|
|
Número de destino
|
to | True | string |
Número de celular do destinatário no formato E.164. Máximo de 100 destinatários, separados com um espaço |
|
Message
|
message | True | string |
Corpo da mensagem SMS |
|
Relatório de entrega
|
delivery_report | boolean |
Os relatórios de entrega podem ser solicitados com cada mensagem. Se os relatórios de entrega forem solicitados, um webhook será enviado para a propriedade callback_url especificada para a mensagem (ou para os webhooks) |
|
|
URL de retorno de chamada
|
callback_url | string |
Uma URL pode ser incluída com cada mensagem para a qual os Webhooks serão enviados por push por meio de uma solicitação HTTP POST |
|
|
Chave de metadados
|
metadata_key | string |
chave de metadados |
|
|
Valor dos metadados
|
metadata_value | string |
valor de metadados |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Os relatórios de entrega podem ser solicitados com cada mensagem. Se os relatórios de entrega forem solicitados, um webhook será enviado para a propriedade callback_url especificada para a mensagem (ou para os webhooks) |
|
destination_number
|
messages.destination_number | string |
número de destino |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
carimbo de data/hora de expiração da mensagem |
|
message_flags
|
messages.message_flags | array of |
sinalizadores de mensagem |
|
message_id
|
messages.message_id | string |
ID da mensagem |
|
Source
|
messages.metadata.Source | string |
Source |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
status
|
messages.status | string |
status |
|
conteúdo
|
messages.content | string |
conteúdo |
|
source_number
|
messages.source_number | string |
número de origem |
|
mídia
|
messages.media | array of string |
mídia |
|
assunto
|
messages.subject | string |
assunto |
Enviar mensagem MMS
Essa ação é usada para enviar uma mensagem multimídia (MMS) para um número de celular.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Número de destino
|
to | True | string |
Número de celular do destinatário no formato E.164. Máximo de 100 destinatários, separados com um espaço |
|
Message
|
message | True | string |
Corpo da mensagem MMS |
|
Conteúdo de Mídia
|
media | byte |
Conteúdo de mídia a ser incluído na mensagem MMS, codificada como uma cadeia de caracteres Base64. Os tipos de mídia com suporte incluem imagens (JPEG, PNG, GIF), vídeos (MP4) e arquivos de áudio (MP3). O tamanho máximo do arquivo para cada anexo de mídia é de 600 kB. |
|
|
ID do remetente
|
source_number | string |
Especificar um número de origem compatível com MMS a ser usado |
|
|
Chave de metadados
|
metadata_key | string |
Chave de metadados |
|
|
Valor dos metadados
|
metadata_value | string |
Valor dos metadados |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
messages
|
messages | array of object |
messages |
|
callback_url
|
messages.callback_url | string |
callback_url |
|
delivery_report
|
messages.delivery_report | boolean |
Relatórios de entrega podem ser solicitados com cada mensagem |
|
destination_number
|
messages.destination_number | string |
número de destino |
|
format
|
messages.format | string |
format |
|
message_expiry_timestamp
|
messages.message_expiry_timestamp | string |
carimbo de data/hora de expiração da mensagem |
|
message_id
|
messages.message_id | string |
ID da mensagem |
|
Source
|
messages.metadata.Source | string |
Source |
|
scheduled
|
messages.scheduled | string |
scheduled |
|
status
|
messages.status | string |
status |
|
conteúdo
|
messages.content | string |
conteúdo |
|
source_number
|
messages.source_number | string |
número de origem |
|
mídia
|
messages.media | array of string |
mídia |
|
assunto
|
messages.subject | string |
assunto |
Enviar RCS (Mensagem de Rich Text)
Enviar mensagem RCS para um destinatário móvel.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
Obter IDs do remetente
Obtenha uma lista de IDs do Remetente vinculadas à sua conta.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
página
|
pagination.page | integer |
página |
|
page_size
|
pagination.page_size | integer |
page_size |
|
total_count
|
pagination.total_count | integer |
total_count |
|
page_count
|
pagination.page_count | integer |
page_count |
|
tipo
|
default_sender.type | string |
tipo |
|
número
|
default_sender.number | string |
número |
|
source_type
|
default_sender.source_type | string |
source_type |
|
mms_capable
|
default_sender.mms_capable | boolean |
mms_capable |
|
Remetentes
|
senders | array of object |
Remetentes |
|
display_type
|
senders.display_type | string |
display_type |
|
is_default
|
senders.is_default | boolean |
is_default |
|
etiqueta
|
senders.label | string |
etiqueta |
|
mms_capable
|
senders.mms_capable | boolean |
mms_capable |
|
número
|
senders.number | string |
número |
|
display_name
|
senders.display_name | string |
Nome de exibição formatado para o remetente |
|
number_id
|
senders.number_id | string |
number_id |
|
source_type
|
senders.source_type | string |
source_type |
|
tipo
|
senders.type | string |
tipo |
|
number_status
|
senders.number_status | string |
number_status |
|
account_id
|
account_id | string |
account_id |
|
vendor_id
|
vendor_id | string |
vendor_id |
Obter o status da mensagem
Obtenha um status de mensagem usando uma ID de mensagem.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID exclusiva desta mensagem
|
messageId | True | string |
ID exclusiva desta mensagem |
Retornos
- Corpo
- message
Gatilhos
| Quando o recibo de entrega é recebido |
Essa operação é disparada quando você recebe um recibo de entrega de uma mensagem de saída (SMS, RCS, MMS). |
| Quando uma mensagem é recebida |
Essa operação é disparada quando você recebe uma mensagem de entrada (SMS, RCS, MMS). |
Quando o recibo de entrega é recebido
Essa operação é disparada quando você recebe um recibo de entrega de uma mensagem de saída (SMS, RCS, MMS).
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
ID da mensagem original |
|
status
|
status | string |
Relatórios de Entrega indicam o status da mensagem |
|
source_address
|
source_address | string |
endereço de origem |
|
destination_address
|
destination_address | string |
endereço de destino |
|
conteúdo
|
content | string |
conteúdo |
|
tipo
|
type | string |
tipo |
|
delivery_report_id
|
delivery_report_id | string |
ID do relatório de entrega |
|
status_code
|
status_code | string |
Códigos de status fornecem insights mais granulares sobre o status de uma mensagem |
|
submitted_date
|
submitted_date | string |
Carimbo de data/hora da mensagem |
|
date_received
|
date_received | string |
Carimbo de data/hora do provedor |
|
Attachments
|
attachments | array of object |
Attachments |
|
Tipo de anexo
|
attachments.attachment_type | string |
Tipo de anexo |
|
Conteúdo do anexo
|
attachments.attachment_content | string |
Conteúdo do anexo |
|
Nome do anexo
|
attachments.attachment_name | string |
Nome do anexo |
|
Metadados
|
metadata | array of object |
Todos os metadados incluídos na mensagem de envio original |
|
Chave de metadados
|
metadata.metadata_key | string |
Chave de metadados |
|
Valor dos metadados
|
metadata.metadata_value | string |
Valor dos metadados |
Quando uma mensagem é recebida
Essa operação é disparada quando você recebe uma mensagem de entrada (SMS, RCS, MMS).
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
message_id
|
message_id | string |
ID da mensagem original |
|
reply_id
|
reply_id | string |
Uma ID exclusiva para a resposta que esta notificação representa |
|
status
|
status | string |
Relatórios de Entrega indicam o status da mensagem |
|
source_address
|
source_address | string |
endereço de origem |
|
destination_address
|
destination_address | string |
endereço de destino |
|
conteúdo
|
content | string |
O conteúdo da resposta |
|
Conteúdo da mensagem V2 – texto
|
contact_message.text_message.text | string |
Conteúdo da mensagem V2 – texto |
|
tipo
|
type | string |
tipo |
|
status_code
|
status_code | string |
Códigos de status fornecem insights mais granulares sobre o status de uma mensagem |
|
submitted_date
|
submitted_date | string |
Carimbo de data/hora da mensagem |
|
date_received
|
date_received | string |
Carimbo de data/hora do provedor |
|
Attachments
|
attachments | array of object |
Uma lista que contém todos os anexos que foram incluídos na resposta. Esse campo só estará presente se você tiver habilitado o MMS de entrada em sua conta e a resposta contiver anexos |
|
Tipo de anexo
|
attachments.attachment_type | string |
O tipo MIME associado a este anexo |
|
Conteúdo do anexo
|
attachments.attachment_content | string |
O anexo codificado em Base64 |
|
Nome do anexo
|
attachments.attachment_name | string |
O nome do anexo |
|
Metadados
|
metadata | array of object |
Todos os metadados incluídos na solicitação de mensagem de envio original |
|
Chave de metadados
|
metadata.metadata_key | string |
Chave de metadados |
|
Valor dos metadados
|
metadata.metadata_value | string |
Valor dos metadados |
Definições
mensagem
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
callback_url
|
callback_url | string |
Uma URL pode ser incluída com cada mensagem para a qual os Webhooks serão enviados por push por meio de uma solicitação HTTP POST |
|
delivery_report
|
delivery_report | boolean |
Os relatórios de entrega podem ser solicitados com cada mensagem. Se os relatórios de entrega forem solicitados, um webhook será enviado para a propriedade callback_url especificada para a mensagem (ou para os webhooks) |
|
destination_number
|
destination_number | string |
O número de destino para o qual a mensagem deve ser entregue |
|
format
|
format | string |
O formato especifica qual formato a mensagem será enviada como SMS (mensagem de texto), MMS (mensagem multimídia) ou TTS (texto em fala) |
|
message_expiry_timestamp
|
message_expiry_timestamp | string |
Um carimbo de data/hora de expiração da mensagem pode ser fornecido para especificar a hora mais recente em que a mensagem deve ser entregue |
|
message_flags
|
message_flags | array of |
message_flags |
|
message_id
|
message_id | string |
ID da mensagem |
|
Source
|
metadata.Source | string |
Source |
|
scheduled
|
scheduled | string |
Hora da data de entrega agendada da mensagem |
|
status
|
status | string |
O status da mensagem |
|
conteúdo
|
content | string |
conteúdo |
|
source_number
|
source_number | string |
número de origem |
|
mídia
|
media | array of string |
mídia |
|
assunto
|
subject | string |
assunto |