Listar disparos
/broadcastsLista os Broadcasts da conta, com o nome, o estado e as datas de cada um. Não há chamada para criar um Broadcast: ele é criado na tela, em Broadcasts › Enviar (Criar um Broadcast).
curl "https://app.nextagsai.com.br/api/broadcasts" \
-H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY"
const resposta = await fetch('https://app.nextagsai.com.br/api/broadcasts', {
headers: {
'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
},
});
const dados = await resposta.json();
console.log(resposta.status, dados);
import os
import requests
resposta = requests.get(
"https://app.nextagsai.com.br/api/broadcasts",
headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
timeout=30,
)
print(resposta.status_code, resposta.json())
<?php
$ch = curl_init('https://app.nextagsai.com.br/api/broadcasts');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
],
]);
$dados = json_decode(curl_exec($ch), true);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL;
print_r($dados);
Autenticação
Mande a chave de API da conta no cabeçalho X-ACCESS-TOKEN de cada chamada. Veja Autenticação com a chave de API.
Respostas
Os Broadcasts, em data.
dataarray de objeto BroadcastA lista de Broadcasts (até 100).
data[].idintegerO ID do Broadcast.
data[].namestringO nome do Broadcast, como na coluna Nome da lista.
data[].statusstringO estado: DRAFT (rascunho; Draft na lista), NOT_SENT (ainda não saiu, como um Broadcast Pendente ou Agendado), SENTING (Enviando; o nome é escrito assim mesmo), SENT (Enviado) ou CANCELLED (Cancelado).
Valores: DRAFT NOT_SENT SENTING SENT CANCELLED
data[].sent_atstring (data e hora)Quando o envio saiu, em UTC.
Exemplo: 2026-10-20 15:00:00
data[].created_byintegerO ID do administrador que criou.
data[].created_atstring (data e hora)Quando o Broadcast foi criado, em UTC.
Exemplo: 2026-10-20 14:45:00
Parâmetros inválidos.
A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.
Relacionados
Contatos, fluxos e outros identificadores
Guia que usa este endpointLimites, erros e boas práticas
Guia que usa este endpointAcompanhar, reenviar e cancelar disparos
Guia que usa este endpointConsultar disparo
GET /broadcasts/{broadcast_id}Reenviar disparo
POST /broadcasts/{broadcast_id}/resendCancelar disparo
POST /broadcasts/{broadcast_id}/cancelEste conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.