Desativar webhook do assistente
curl --request POST \
--url https://api.example.com/user/assistants/disable-webhook \
--header 'Content-Type: application/json' \
--data '
{
"assistant_id": 123
}
'import requests
url = "https://api.example.com/user/assistants/disable-webhook"
payload = { "assistant_id": 123 }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({assistant_id: 123})
};
fetch('https://api.example.com/user/assistants/disable-webhook', 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.example.com/user/assistants/disable-webhook",
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([
'assistant_id' => 123
]),
CURLOPT_HTTPHEADER => [
"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.example.com/user/assistants/disable-webhook"
payload := strings.NewReader("{\n \"assistant_id\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/user/assistants/disable-webhook")
.header("Content-Type", "application/json")
.body("{\n \"assistant_id\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/user/assistants/disable-webhook")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"assistant_id\": 123\n}"
response = http.request(request)
puts response.read_body{
"message": "Webhook desativado com sucesso",
"data": []
}
{
"message": "Assistente não encontrado"
}
{
"message": "Os dados fornecidos são inválidos.",
"errors": {
"assistant_id": [
"O campo ID do assistente é obrigatório."
]
}
}
Assistants
Desativar webhook do assistente
Desativa as notificações de webhook de um assistente específico, interrompendo o envio automático de eventos e dados pós-chamada para o seu sistema.
POST
/
user
/
assistants
/
disable-webhook
Desativar webhook do assistente
curl --request POST \
--url https://api.example.com/user/assistants/disable-webhook \
--header 'Content-Type: application/json' \
--data '
{
"assistant_id": 123
}
'import requests
url = "https://api.example.com/user/assistants/disable-webhook"
payload = { "assistant_id": 123 }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({assistant_id: 123})
};
fetch('https://api.example.com/user/assistants/disable-webhook', 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.example.com/user/assistants/disable-webhook",
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([
'assistant_id' => 123
]),
CURLOPT_HTTPHEADER => [
"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.example.com/user/assistants/disable-webhook"
payload := strings.NewReader("{\n \"assistant_id\": 123\n}")
req, _ := http.NewRequest("POST", url, payload)
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.example.com/user/assistants/disable-webhook")
.header("Content-Type", "application/json")
.body("{\n \"assistant_id\": 123\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/user/assistants/disable-webhook")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"assistant_id\": 123\n}"
response = http.request(request)
puts response.read_body{
"message": "Webhook desativado com sucesso",
"data": []
}
{
"message": "Assistente não encontrado"
}
{
"message": "Os dados fornecidos são inválidos.",
"errors": {
"assistant_id": [
"O campo ID do assistente é obrigatório."
]
}
}
Este endpoint desativa as notificações de webhook de um assistente, interrompendo todos os envios de atualizações em tempo real sobre conclusões de chamadas e dados.
Comportamento do Webhook
Quando o webhook é desativado:
O assistente deixará de enviar requisições HTTP POST para a URL do webhook
Tanto is_webhook_active será definido como false quanto webhook_url será definido como null
Quaisquer chamadas em andamento serão concluídas normalmente, porém nenhuma notificação de webhook será enviada
Os dados das chamadas continuarão disponíveis através dos endpoints de chamadas da API
Observações
O assistente deve pertencer ao usuário autenticado
Esta ação remove completamente a configuração de webhook do assistente
Você pode reativar os webhooks posteriormente utilizando o endpoint de habilitar webhook com uma nova URL
Desativar webhooks não afeta a gravação de chamadas nem a coleta de dados
Corpo da Requisição
integer
required
O ID do assistente para o qual o webhook será desativado
Resposta
string
Mensagem de sucesso confirmando que o webhook foi desativado
array
Array vazio (reservado para uso futuro)
Respostas de Erro
Show Resposta de Erro
Show Resposta de Erro
string
Mensagem de erro quando o assistente não é encontrado ou não pertence ao usuário autenticado
{
"message": "Webhook desativado com sucesso",
"data": []
}
{
"message": "Assistente não encontrado"
}
{
"message": "Os dados fornecidos são inválidos.",
"errors": {
"assistant_id": [
"O campo ID do assistente é obrigatório."
]
}
}
⌘I