Preencher campo do bot

POST/accounts/bot_fields/{bot_field_id}

Gerada do contrato OpenAPI

Troca o valor de um campo do bot: todos os fluxos que usam o campo passam a mostrar o valor novo. Use quando o valor vem de outro sistema, como o preço do dia ou o cupom da semana. O valor vai em formulário, no formato do tipo do campo: data e data e hora em Unix timestamp (segundos) e sim/não como 1 ou 0.

Requisição

curl -X POST "https://app.nextagsai.com.br/api/accounts/bot_fields/3101" \
  -H "X-ACCESS-TOKEN: $NEXTAGS_API_KEY" \
  --data-urlencode 'value=Seg a sex, das 9h às 18h'

const resposta = await fetch('https://app.nextagsai.com.br/api/accounts/bot_fields/3101', {
  method: 'POST',
  headers: {
    'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY,
  },
  body: new URLSearchParams({
    value: 'Seg a sex, das 9h às 18h',
  }),
});
const dados = await resposta.json();
console.log(resposta.status, dados);

import os

import requests

resposta = requests.post(
    "https://app.nextagsai.com.br/api/accounts/bot_fields/3101",
    headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]},
    data={
        "value": "Seg a sex, das 9h às 18h",
    },
    timeout=30,
)
print(resposta.status_code, resposta.json())

<?php
$ch = curl_init('https://app.nextagsai.com.br/api/accounts/bot_fields/3101');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'),
    ],
    CURLOPT_POSTFIELDS => http_build_query([
        'value' => 'Seg a sex, das 9h às 18h',
    ]),
]);
$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.

Parâmetros de caminho

bot_field_idintegerobrigatório

O ID do campo do bot.

Corpo da requisição

FormulárioContent-Type: application/x-www-form-urlencoded

valuestringobrigatório

O valor novo, no formato do tipo do campo.

Exemplo: Seg a sex, das 9h às 18h

Respostas

200Sucesso

O valor foi gravado.

successboolean

true quando o valor foi gravado.

401Chave inválida

A chave de API não veio no cabeçalho ou não vale (foi excluída ou está incompleta). Veja Autenticação.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.

const resposta = await fetch('https://app.nextagsai.com.br/api/accounts/bot_fields/3101', { method: 'POST', headers: { 'X-ACCESS-TOKEN': process.env.NEXTAGS_API_KEY, }, body: new URLSearchParams({ value: 'Seg a sex, das 9h às 18h', }), }); const dados = await resposta.json(); console.log(resposta.status, dados);

import os import requests resposta = requests.post( "https://app.nextagsai.com.br/api/accounts/bot_fields/3101", headers={"X-ACCESS-TOKEN": os.environ["NEXTAGS_API_KEY"]}, data={ "value": "Seg a sex, das 9h às 18h", }, timeout=30, ) print(resposta.status_code, resposta.json())

<?php $ch = curl_init('https://app.nextagsai.com.br/api/accounts/bot_fields/3101'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'X-ACCESS-TOKEN: ' . getenv('NEXTAGS_API_KEY'), ], CURLOPT_POSTFIELDS => http_build_query([ 'value' => 'Seg a sex, das 9h às 18h', ]), ]); $dados = json_decode(curl_exec($ch), true); echo curl_getinfo($ch, CURLINFO_HTTP_CODE), PHP_EOL; print_r($dados);

Autenticação

Parâmetros de caminho

Corpo da requisição

Respostas

Relacionados

Visão geral da API

Campos personalizados, campos do bot e variáveis

Etiquetar contatos e preencher campos

Campos do bot: um valor para a conta toda

Consultar campo do bot

Limpar campo do bot