Vonage (versión preliminar)
La plataforma de API vonage le permite agregar comunicaciones dentro del contexto de las aplicaciones, incluidos SMS, Voz y Chat. Regístrese aquí para obtener una cuenta de Nexmo: https://www.vonage.com/
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Soporte técnico de Vonage |
| URL | https://www.vonage.co.uk/support |
| Correo Electrónico | support@vonage.com |
| Metadatos del conector | |
|---|---|
| Publicador | Vonage |
| Sitio web | https://vonage.com |
| Directiva de privacidad | https://www.vonage.com/legal/privacy-policy |
| Categorías | Communication |
La plataforma de API vonage le permite agregar comunicaciones dentro del contexto de las aplicaciones, incluidos SMS, Voz y Chat.
Prerrequisitos
Necesitará lo siguiente para continuar:
- Una cuenta de Vonage, regístrese en https://dashboard.nexmo.com/sign-up
Obtención de credenciales
Para obtener las credenciales, puede registrarse para obtener una cuenta gratuita de Vonage en https://dashboard.nexmo.com/sign-up
Problemas y limitaciones conocidos
Actualmente, este conector no expone todos los productos y API de Vonage.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Comprobación de comprobación |
Confirma que el PIN que recibió del usuario coincide con la solicitud Verify |
| Enviar un mensaje al canal determinado |
Enviar un mensaje |
| Proporciona información básica sobre números sobre un número. |
Proporciona información básica sobre números sobre un número. |
| Proporciona información de información de número estándar sobre un número. |
Proporciona información de información de número estándar sobre un número. |
| Solicitud de una comprobación |
Use Verify request (Comprobar solicitud) para generar y enviar un PIN al usuario |
Comprobación de comprobación
Confirma que el PIN que recibió del usuario coincide con la solicitud Verify
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
El formato de respuesta
|
format | True | string |
El formato de respuesta |
|
La clave de API
|
api_key | True | string |
La clave de API |
|
Secreto de API
|
api_secret | True | string |
Secreto de API |
|
Este es el request_id que recibió en la respuesta a la solicitud Verify
|
request_id | True | string |
Este es el request_id que recibió en la respuesta a la solicitud Verify |
|
El código de verificación escrito por el usuario
|
code | True | string |
El código de verificación escrito por el usuario |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
identificador_de_solicitud
|
request_id | string | |
|
event_id
|
event_id | string | |
|
estado
|
status | string | |
|
precio
|
price | string | |
|
divisa
|
currency | string | |
|
estimated_price_messages_sent
|
estimated_price_messages_sent | string |
Enviar un mensaje al canal determinado
Enviar un mensaje
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Tipo de contenido para solicitud
|
Content-Type | True | string |
Tipo de contenido |
|
Tipo de fecha aceptado
|
Accept | True | string |
Aceptar |
|
Tipo de mensaje que se va a enviar. Debe proporcionar texto en este campo.
|
message_type | string |
Tipo de mensaje que se va a enviar. Debe proporcionar texto en este campo. |
|
|
Texto del mensaje que se va a enviar; limitado a 1000 caracteres
|
text | string |
Texto del mensaje que se va a enviar; limitado a 1000 caracteres |
|
|
Número de teléfono del destinatario del mensaje en formato E.164
|
to | string |
Número de teléfono del destinatario del mensaje en formato E.164 |
|
|
Número de teléfono del destinatario del mensaje en formato E.164
|
from | string |
Número de teléfono del destinatario del mensaje en formato E.164 |
|
|
Canal al que se va a enviar. Debe proporcionar sms en este campo.
|
channel | string |
Canal al que se va a enviar. Debe proporcionar sms en este campo. |
|
|
Referencia de cliente de hasta 40 caracteres
|
client_ref | string |
Referencia de cliente de hasta 40 caracteres |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
message_uuid
|
message_uuid | string |
message_uuid |
Proporciona información básica sobre números sobre un número.
Proporciona información básica sobre números sobre un número.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
El formato de respuesta
|
format | True | string |
El formato de respuesta |
|
La clave de API
|
api_key | True | string |
La clave de API |
|
Secreto de API
|
api_secret | True | string |
Secreto de API |
|
Número de teléfono que necesita información sobre en formato nacional o internacional
|
number | True | string |
Número de teléfono que necesita información sobre en formato nacional o internacional |
|
Código de país de dos caracteres en formato alfa-2 ISO 3166-1, por ejemplo. GB o EE. UU.
|
country | True | string |
Código de país de dos caracteres en formato alfa-2 ISO 3166-1, por ejemplo. GB o EE. UU. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer | |
|
status_message
|
status_message | string | |
|
identificador_de_solicitud
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string |
Proporciona información de información de número estándar sobre un número.
Proporciona información de información de número estándar sobre un número.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
El formato de respuesta
|
format | True | string |
El formato de respuesta |
|
La clave de API
|
api_key | True | string |
La clave de API |
|
Secreto de API
|
api_secret | True | string |
Secreto de API |
|
Número de teléfono que necesita información sobre en formato nacional o internacional
|
number | True | string |
Número de teléfono que necesita información sobre en formato nacional o internacional |
|
Código de país de dos caracteres en formato alfa-2 ISO 3166-1, por ejemplo. GB o EE. UU.
|
country | True | string |
Código de país de dos caracteres en formato alfa-2 ISO 3166-1, por ejemplo. GB o EE. UU. |
|
Establézcalo en true para recibir el nombre del propietario del número de teléfono en la respuesta.
|
cnam | string |
Establézcalo en true para recibir el nombre del propietario del número de teléfono en la respuesta. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | integer | |
|
status_message
|
status_message | string | |
|
identificador_de_solicitud
|
request_id | string | |
|
international_format_number
|
international_format_number | string | |
|
national_format_number
|
national_format_number | string | |
|
country_code
|
country_code | string | |
|
country_code_iso3
|
country_code_iso3 | string | |
|
country_name
|
country_name | string | |
|
country_prefix
|
country_prefix | string | |
|
request_price
|
request_price | string | |
|
refund_price
|
refund_price | string | |
|
remaining_balance
|
remaining_balance | string | |
|
network_code
|
current_carrier.network_code | string | |
|
nombre
|
current_carrier.name | string | |
|
country
|
current_carrier.country | string | |
|
network_type
|
current_carrier.network_type | string | |
|
network_code
|
original_carrier.network_code | string | |
|
nombre
|
original_carrier.name | string | |
|
country
|
original_carrier.country | string | |
|
network_type
|
original_carrier.network_type | string | |
|
Portado
|
ported | string | |
|
caller_type
|
caller_identity.caller_type | string | |
|
caller_name
|
caller_identity.caller_name | string | |
|
first_name
|
caller_identity.first_name | string | |
|
last_name
|
caller_identity.last_name | string | |
|
caller_name
|
caller_name | string | |
|
last_name
|
last_name | string | |
|
first_name
|
first_name | string | |
|
caller_type
|
caller_type | string |
Solicitud de una comprobación
Use Verify request (Comprobar solicitud) para generar y enviar un PIN al usuario
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
El formato de respuesta
|
format | True | string |
El formato de respuesta |
|
Puede encontrar la clave de API en el panel de la cuenta. https://dashboard.nexmo.com
|
api_key | True | string |
Puede encontrar la clave de API en el panel de la cuenta. https://dashboard.nexmo.com |
|
Puede encontrar el secreto de API en el panel. https://dashboard.nexmo.com
|
api_secret | True | string |
Puede encontrar el secreto de API en el panel. https://dashboard.nexmo.com |
|
Número de teléfono móvil o de línea fija que se va a comprobar. El número debe estar en formato E.164
|
number | True | string |
Número de teléfono móvil o de línea fija que se va a comprobar. El número debe estar en formato E.164 |
|
Especifique el código de país de dos caracteres, compruebe que dará formato al número.
|
country | string |
Especifique el código de país de dos caracteres, compruebe que dará formato al número. |
|
|
Una cadena alfanumérica de 18 caracteres, use para personalizar el cuerpo de sms de la solicitud.
|
brand | True | string |
Una cadena alfanumérica de 18 caracteres, use para personalizar el cuerpo de sms de la solicitud. |
|
Cadena alfanumérica de 11 caracteres que representa la identidad del remitente
|
sender_id | string |
Cadena alfanumérica de 11 caracteres que representa la identidad del remitente |
|
|
Longitud del código de verificación
|
code_length | integer |
Longitud del código de verificación |
|
|
Controlar el idioma usado para la solicitud Verify
|
lg | string |
Controlar el idioma usado para la solicitud Verify |
|
|
Cuánto tiempo es válido el código de verificación generado, en segundos
|
pin_expiry | integer |
Cuánto tiempo es válido el código de verificación generado, en segundos |
|
|
Tiempo de espera en segundos entre los intentos de entregar el código de verificación
|
next_event_wait | integer |
Tiempo de espera en segundos entre los intentos de entregar el código de verificación |
|
|
Secuencia predefinida de acciones de SMS y TTS para transmitir el PIN al usuario
|
workflow_id | integer |
Secuencia predefinida de acciones de SMS y TTS para transmitir el PIN al usuario |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
estado
|
status | string | |
|
identificador_de_solicitud
|
request_id | string |