External Accounts API

The External Accounts API is used to manage accounts for Viber Business Messages, Facebook Messenger and Whatsapp for use in the Messages and Dispatch APIs.

Baixar a especificação OpenAPI

Application

Inbound messages to an external account which is linked to an application will be delivered to the application's inbound URL.

Link application to an account

posthttps://api.nexmo.com/beta/chatapp-accounts/:provider/:external_id/applications

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

provider
string
Obrigatório

Provider of the account you want to assign an application to

Deve ser uma das seguintes opções:messengerviber_service_msgwhatsapprcs
external_id
string
Obrigatório

External id of the account you want to assign an application to. This is channel dependent. For Facebook it will be your Facebook Page ID, for Viber your Viber Service Message ID and for WhatsApp your WhatsApp number, for RCS it will be the RCS Agent ID.

Corpo da solicitação
Tipo de conteúdo
application/json

application
string
Obrigatório
exemplo78d335fa-323d-0114-9c3d-d6f0d48968cf

There is just one application allowed per an account. The application type must be type "messages". For more information please see Application API Spec

Exemplo Solicitação

{
   "application": "78d335fa-323d-0114-9c3d-d6f0d48968cf"
}
{
   "application": "78d335fa-323d-0114-9c3d-d6f0d48968cf"
}

Respostas
Tipo de conteúdo
application/json

OK.

name
string
exemploname

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplomessenger

The provider (will be one of messenger, viber_service_msg, whatsapp, rcs).

Deve ser uma das seguintes opções:messengerviber_service_msgwhatsapprcs
access_token
string
exemploaccessToken

The provider access token (only for messenger)

Exemplo Resposta

{
   "name": "name",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "messenger",
   "access_token": "accessToken"
}

Unlink application from an account

deletehttps://api.nexmo.com/beta/chatapp-accounts/:provider/:external_id/applications/:application_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

provider
string
Obrigatório

Provider of the account you want to unlink an application from

Deve ser uma das seguintes opções:messengerviber_service_msgwhatsapprcs
external_id
string
Obrigatório

External id of the account you want to unlink an application from

application_id
string
Obrigatório

Id of the application you want to unlink

Respostas

No Content.

Account

An external-account used as the from field in the Messages API and Dispatch API

Operações disponíveis

Retrieve all accounts you own

gethttps://api.nexmo.com/beta/chatapp-accounts/

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Consulta Parâmetros

provider
string

Filter by provider

Deve ser uma das seguintes opções:messengerviber_service_msgwhatsapprcs
page_number
integer
Padrão1
exemplo1

Page number of the results

page_size
integer
Padrão20
exemplo1

Page size of the results

Respostas
Tipo de conteúdo
application/json

OK.

page_number
integer
exemplo1
page_size
integer
exemplo10
_embedded
array
name
string
exemplooptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplo[ "messenger", "viber_service_msg", "whatsapp" ]

The provider (will be messenger).

access_token
string
Obrigatório
exemplomyAccessToken

The provider access token

_links
object
self
object
href
string
exemplohttps://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10
next
object
href
string
exemplohttps://api.nexmo.com/beta/chatapp-accounts?page_number=3&page_size=10
prev
object
href
string
exemplohttps://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10
first
object
href
string
exemplohttps://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10
last
object
href
string
exemplohttps://api.nexmo.com/beta/chatapp-accounts?page_number=4&page_size=10

Exemplo Resposta

{
   "page_number": 1,
   "page_size": 10,
   "_embedded": [
      {
         "name": "optionalName",
         "applications": [
            "optionalApplicationId"
         ],
         "external_id": "12345678",
         "api_key": "abcd1234",
         "provider": "whatsapp",
         "access_token": "myAccessToken"
      }
   ],
   "_links": {
      "self": {
         "href": "https://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10"
      },
      "next": {
         "href": "https://api.nexmo.com/beta/chatapp-accounts?page_number=3&page_size=10"
      },
      "prev": {
         "href": "https://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10"
      },
      "first": {
         "href": "https://api.nexmo.com/beta/chatapp-accounts?page_number=1&page_size=10"
      },
      "last": {
         "href": "https://api.nexmo.com/beta/chatapp-accounts?page_number=4&page_size=10"
      }
   }
}

Facebook Messenger

Managing your Facebook Messenger account

Create a Messenger account

posthttps://api.nexmo.com/beta/chatapp-accounts/messenger

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Corpo da solicitação
Tipo de conteúdo
application/json

external_id
string
Obrigatório
exemplo12345678

This is the unique identifier within the provider's domain. In this case it is the Page ID for your Facebook Page. Go to your Facebook Page, click "Settings", click "Messenger platform " scroll down to "Messenger link" to find your Page ID.

access_token
string
Obrigatório
exemplomyAccessToken

This is the Facebook Business Page token. You can obtain the token using one of the following methods:

name
string
exemplooptionalName

Custom account name

applications
array

Contains a list of application IDs which are linked to the account.

  • There is just one application allowed per an account.
  • The application type must be type "messages".
For more information see Application API spec

Exemplo Solicitação

{
   "external_id": "12345678",
   "access_token": "myAccessToken",
   "name": "optionalName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ]
}
{
   "external_id": "12345678",
   "access_token": "myAccessToken"
}

Respostas
Tipo de conteúdo
application/json

Created.

name
string
exemplooptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplomessenger

The provider (will be messenger).

access_token
string
Obrigatório
exemplomyAccessToken

The provider access token

Exemplo Resposta

{
   "name": "optionalName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "messenger",
   "access_token": "myAccessToken"
}

Retrieve a Messenger account

gethttps://api.nexmo.com/beta/chatapp-accounts/messenger/:external_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

external_id
string
Obrigatório

External id of the account you want to retrieve. In this case it is the Facebook Page ID.

Respostas
Tipo de conteúdo
application/json

OK.

name
string
exemplooptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplomessenger

The provider (will be messenger).

access_token
string
Obrigatório
exemplomyAccessToken

The provider access token

Exemplo Resposta

{
   "name": "optionalName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "messenger",
   "access_token": "myAccessToken"
}

Update a Messenger account

patchhttps://api.nexmo.com/beta/chatapp-accounts/messenger/:external_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

external_id
string
Obrigatório

External id of the account you want to update. In this case it is the Facebook Page ID.

Corpo da solicitação
Tipo de conteúdo
application/json

name
string
exemplonewName

The new account name

applications
array
access_token
string
exemploupdatedAccessToken

Exemplo Solicitação

{
   "name": "newName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "access_token": "updatedAccessToken"
}
{}

Respostas
Tipo de conteúdo
application/json

OK.

name
string
exemplonewName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account. In this case it is the Facebook Page ID.

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplomessenger

The provider (will be messenger).

access_token
string
Obrigatório
exemploupdatedAccessToken

The provider access token

Exemplo Resposta

{
   "name": "newName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "messenger",
   "access_token": "updatedAccessToken"
}

Delete a Messenger account

deletehttps://api.nexmo.com/beta/chatapp-accounts/messenger/:external_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

external_id
string
Obrigatório

External id of the account you want to delete. In this case it is the Facebook Page ID.

Respostas

No Content.

Viber Service Message

Managing your Viber Service Message account

Retrieve a Viber Service Message account

gethttps://api.nexmo.com/beta/chatapp-accounts/viber_service_msg/:external_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

external_id
string
Obrigatório

External id of the account you want to retrieve. In this case it will be your Viber Service Message ID.

Respostas
Tipo de conteúdo
application/json

OK.

name
string
exemplooptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemploviber_service_msg

The provider (will be viber_service_msg).

Exemplo Resposta

{
   "name": "optionalName",
   "applications": [
      "78d335fa-323d-0114-9c3d-d6f0d48968cf"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "viber_service_msg"
}

Whatsapp

Managing your Whatsapp account

Operações disponíveis

Retrieve a Whatsapp account

gethttps://api.nexmo.com/beta/chatapp-accounts/whatsapp/:external_id

Autenticação

Esta API oferece suporte tanto à autenticação JWT quanto à autenticação básica. A autenticação básica é mais fácil de começar a usar, mas não oferece suporte a recursos avançados, como ACLs.

Você pode usar ou a autenticação JWT ou a autenticação básica, mas não ambas ao mesmo tempo.

ChaveDescriçãoOndeExemplo
Authorization

Seu token JSON da Web.
Saiba mais sobre os JWTs

Headers

Bearer <JWT>
Authorization

Chave e segredo da API codificados em Base64, separados por dois pontos.
Leia mais

Headers

Basic <base64>

Caminho Parâmetros

external_id
string
Obrigatório

External id of the account you want to retrieve. In this case it will be the WhatsApp number.

Respostas
Tipo de conteúdo
application/json

OK.

name
string
exemplooptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Obrigatório
exemplo12345678

The external identifier for this account

api_key
string
Obrigatório
exemploabcd1234

The external api key for this account

provider
string
Obrigatório
exemplowhatsapp

The provider (will be whatsapp).

Exemplo Resposta

{
   "name": "optionalName",
   "applications": [
      "optionalApplicationId"
   ],
   "external_id": "12345678",
   "api_key": "abcd1234",
   "provider": "whatsapp"
}