Meetings

Connect Attendee

Store the Attendee account your agents join meetings through: https://app.attendee.dev with a key from your project there, or your own Attendee install. The key is checked against Attendee first and stored encrypted; it is never returned. Calling this again replaces what is stored.

Attendee bills you directly for bot hours. Wixzel never runs Attendee for you and adds nothing to that bill. For Zoom meetings your Attendee project also needs Zoom credentials (a Zoom Meeting SDK app). Requires calls:write.

POST

meetings

integration

Connect Attendee

curl --request POST \
  --url https://api.voice.wixzel.com/v1/meetings/integration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "attendee",
  "base_url": "https://app.attendee.dev",
  "api_key": "<string>",
  "webhook_secret": "<string>",
  "signed_in_bots": {
    "google_meet": false,
    "teams": false,
    "login_group": null
  }
}
'

import requests

url = "https://api.voice.wixzel.com/v1/meetings/integration"

payload = {
    "provider": "attendee",
    "base_url": "https://app.attendee.dev",
    "api_key": "<string>",
    "webhook_secret": "<string>",
    "signed_in_bots": {
        "google_meet": False,
        "teams": False,
        "login_group": None
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'attendee',
    base_url: 'https://app.attendee.dev',
    api_key: '<string>',
    webhook_secret: '<string>',
    signed_in_bots: {google_meet: false, teams: false, login_group: null}
  })
};

fetch('https://api.voice.wixzel.com/v1/meetings/integration', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.voice.wixzel.com/v1/meetings/integration",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'attendee',
    'base_url' => 'https://app.attendee.dev',
    'api_key' => '<string>',
    'webhook_secret' => '<string>',
    'signed_in_bots' => [
        'google_meet' => false,
        'teams' => false,
        'login_group' => null
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.voice.wixzel.com/v1/meetings/integration"

	payload := strings.NewReader("{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.voice.wixzel.com/v1/meetings/integration")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.voice.wixzel.com/v1/meetings/integration")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "meeting_integration",
  "provider": "attendee",
  "base_url": "<string>",
  "api_key_last4": "<string>",
  "webhook_secret_set": true,
  "signed_in_bots": {
    "google_meet": false,
    "teams": false,
    "login_group": null
  },
  "status": "connected",
  "last_error": "<string>",
  "verified_at": "2026-09-01T12:00:00.000Z",
  "created_at": "2026-09-01T12:00:00.000Z",
  "updated_at": "2026-09-01T12:00:00.000Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Your Wixzel Voice API key: Authorization: Bearer wv_live_.... Keys are scoped; grant only what the integration needs.

Body

application/json

provider

enum<string>

default:attendee

The meeting-bot service. Only Attendee today.

Available options:

attendee

base_url

string<uri>

default:https://app.attendee.dev

Your Attendee: https://app.attendee.dev for the hosted app, or the address of your own install.

Maximum string length: 500

Example:

"https://app.attendee.dev"

api_key

string

An API key from your Attendee project. Checked against Attendee before it is saved; never returned. Required the first time and whenever base_url changes; omit it to keep the stored key.

Required string length: 8 - 500

webhook_secret

string | null

Optional: your Attendee project's webhook secret (Settings → Webhooks there). When set, every bot state webhook is checked against its X-Webhook-Signature as well as the per-meeting token in its URL. Pass null to remove it; omit it to keep what is stored.

Required string length: 8 - 500

signed_in_bots

object

Sign bots into an account before they join, so Google Meet and Teams show a named participant instead of an anonymous guest (which Meet labels "appears to be a bot"). Set up bot logins in your Attendee first (Settings → Bot Logins). Omit to keep what is stored. Not available for Zoom.

Show child attributes

Response

The connected integration

object

enum<string>

required

Available options:

meeting_integration

provider

enum<string>

required

Available options:

attendee

base_url

string

required

api_key_last4

string

required

The end of the stored key, to tell keys apart.

webhook_secret_set

boolean

required

signed_in_bots

object

required

Show child attributes

status

enum<string>

required

Available options:

connected,

error

last_error

string | null

required

verified_at

string<date-time> | null

required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"

created_at

string<date-time>

required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"

updated_at

string<date-time>

required

ISO 8601, always UTC.

Example:

"2026-09-01T12:00:00.000Z"

Connect Attendee

curl --request POST \
  --url https://api.voice.wixzel.com/v1/meetings/integration \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "provider": "attendee",
  "base_url": "https://app.attendee.dev",
  "api_key": "<string>",
  "webhook_secret": "<string>",
  "signed_in_bots": {
    "google_meet": false,
    "teams": false,
    "login_group": null
  }
}
'

import requests

url = "https://api.voice.wixzel.com/v1/meetings/integration"

payload = {
    "provider": "attendee",
    "base_url": "https://app.attendee.dev",
    "api_key": "<string>",
    "webhook_secret": "<string>",
    "signed_in_bots": {
        "google_meet": False,
        "teams": False,
        "login_group": None
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    provider: 'attendee',
    base_url: 'https://app.attendee.dev',
    api_key: '<string>',
    webhook_secret: '<string>',
    signed_in_bots: {google_meet: false, teams: false, login_group: null}
  })
};

fetch('https://api.voice.wixzel.com/v1/meetings/integration', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.voice.wixzel.com/v1/meetings/integration",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'provider' => 'attendee',
    'base_url' => 'https://app.attendee.dev',
    'api_key' => '<string>',
    'webhook_secret' => '<string>',
    'signed_in_bots' => [
        'google_meet' => false,
        'teams' => false,
        'login_group' => null
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.voice.wixzel.com/v1/meetings/integration"

	payload := strings.NewReader("{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.voice.wixzel.com/v1/meetings/integration")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.voice.wixzel.com/v1/meetings/integration")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"provider\": \"attendee\",\n  \"base_url\": \"https://app.attendee.dev\",\n  \"api_key\": \"<string>\",\n  \"webhook_secret\": \"<string>\",\n  \"signed_in_bots\": {\n    \"google_meet\": false,\n    \"teams\": false,\n    \"login_group\": null\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "meeting_integration",
  "provider": "attendee",
  "base_url": "<string>",
  "api_key_last4": "<string>",
  "webhook_secret_set": true,
  "signed_in_bots": {
    "google_meet": false,
    "teams": false,
    "login_group": null
  },
  "status": "connected",
  "last_error": "<string>",
  "verified_at": "2026-09-01T12:00:00.000Z",
  "created_at": "2026-09-01T12:00:00.000Z",
  "updated_at": "2026-09-01T12:00:00.000Z"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "agent_not_found",
    "message": "<string>",
    "request_id": "req_01HXYZ...",
    "param": "<string>",
    "doc_url": "<string>"
  }
}

Getting started

Guides

Carriers

Concepts

API reference

Connect Attendee

Authorizations

Body

Response