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.

OpenAPI-Spezifikation herunterladen

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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

provider
string
Erforderlich

Provider of the account you want to assign an application to

Muss eines der folgenden sein:messengerviber_service_msgwhatsapprcs
external_id
string
Erforderlich

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.

Anfrage Körper
Inhalt Typ
application/json

application
string
Erforderlich
Beispiel78d335fa-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

Beispiel Anfrage

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

Antworten
Inhalt Typ
application/json

OK.

name
string
Beispielname

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielmessenger

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

Muss eines der folgenden sein:messengerviber_service_msgwhatsapprcs
access_token
string
BeispielaccessToken

The provider access token (only for messenger)

Beispiel Antwort

{
   "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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

provider
string
Erforderlich

Provider of the account you want to unlink an application from

Muss eines der folgenden sein:messengerviber_service_msgwhatsapprcs
external_id
string
Erforderlich

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

application_id
string
Erforderlich

Id of the application you want to unlink

Antworten

No Content.

Account

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

Verfügbare Operationen

Retrieve all accounts you own

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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Abfrage Parameter

provider
string

Filter by provider

Muss eines der folgenden sein:messengerviber_service_msgwhatsapp
page_number
integer
Standard1
Beispiel1

Page number of the results

page_size
integer
Standard20
Beispiel1

Page size of the results

Antworten
Inhalt Typ
application/json

OK.

page_number
integer
Beispiel1
page_size
integer
Beispiel10
_embedded
array
name
string
BeispieloptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispiel[ "messenger", "viber_service_msg", "whatsapp" ]

The provider (will be messenger).

access_token
string
Erforderlich
BeispielmyAccessToken

The provider access token

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

Beispiel Antwort

{
   "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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Anfrage Körper
Inhalt Typ
application/json

external_id
string
Erforderlich
Beispiel12345678

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
Erforderlich
BeispielmyAccessToken

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

name
string
BeispieloptionalName

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

Beispiel Anfrage

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

Antworten
Inhalt Typ
application/json

Created.

name
string
BeispieloptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielmessenger

The provider (will be messenger).

access_token
string
Erforderlich
BeispielmyAccessToken

The provider access token

Beispiel Antwort

{
   "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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

external_id
string
Erforderlich

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

Antworten
Inhalt Typ
application/json

OK.

name
string
BeispieloptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielmessenger

The provider (will be messenger).

access_token
string
Erforderlich
BeispielmyAccessToken

The provider access token

Beispiel Antwort

{
   "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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

external_id
string
Erforderlich

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

Anfrage Körper
Inhalt Typ
application/json

name
string
BeispielnewName

The new account name

applications
array
access_token
string
BeispielupdatedAccessToken

Beispiel Anfrage

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

Antworten
Inhalt Typ
application/json

OK.

name
string
BeispielnewName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

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

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielmessenger

The provider (will be messenger).

access_token
string
Erforderlich
BeispielupdatedAccessToken

The provider access token

Beispiel Antwort

{
   "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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

external_id
string
Erforderlich

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

Antworten

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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

external_id
string
Erforderlich

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

Antworten
Inhalt Typ
application/json

OK.

name
string
BeispieloptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielviber_service_msg

The provider (will be viber_service_msg).

Beispiel Antwort

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

Whatsapp

Managing your Whatsapp account

Verfügbare Operationen

Retrieve a Whatsapp account

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

Authentifizierung

Diese API unterstützt sowohl die JWT- als auch die Basis-Authentifizierung. Die Basisauthentifizierung ist einfacher zu handhaben, unterstützt aber keine erweiterten Funktionen wie ACLs.

Sie können entweder JWT oder Basic Authentication verwenden, aber nicht beides gleichzeitig.

SchlüsselBeschreibungWoBeispiel
Authorization

Ihr JSON-Web-Token.
Lesen Sie mehr über JWTs

Headers

Bearer <JWT>
Authorization

Base64-kodierter API-Schlüssel und Geheimnis, verbunden durch einen Doppelpunkt.
Mehr lesen

Headers

Basic <base64>

Pfad Parameter

external_id
string
Erforderlich

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

Antworten
Inhalt Typ
application/json

OK.

name
string
BeispieloptionalName

The account name

applications
array

The array of associated application ids

external_id
string
Erforderlich
Beispiel12345678

The external identifier for this account

api_key
string
Erforderlich
Beispielabcd1234

The external api key for this account

provider
string
Erforderlich
Beispielwhatsapp

The provider (will be whatsapp).

Beispiel Antwort

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