Tokens de API

Este guia acompanha a tela Tokens de API do painel (Conta → Tokens de API).

Para que serve

Gerar um token secreto para o seu CRM ou sistema externo cadastrar/atualizar contatos na sua base via API — sem usar o login do painel.

O que você vai fazer

1. Abrir Conta → Tokens de API.
2. Clicar em Criar token e dar um nome (ex.: “Integração RD Station”).
3. Copiar o token imediatamente — por segurança ele não aparece de novo.
4. No seu sistema, enviar o cabeçalho Authorization: Bearer seguido do token.
5. Se o token vazar ou deixar de ser usado, clique em Revogar.

Exemplo (cadastrar ou atualizar um contato)

Limite: 60 requisições por minuto por token.

curl (bash)

curl -X POST "https://api.brenvio.com.br/api/v1/integration/contacts" \
  -H "Authorization: Bearer SEU_TOKEN_AQUI" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: pt-BR" \
  -d '{
    "email": "helena@empresa.com",
    "name": "Helena",
    "country_code": "55",
    "phone_number": "11988887777",
    "tags": ["Lead CRM"],
    "fields": { "empresa": "Acme" }
  }'

JavaScript (fetch)

await fetch("https://api.brenvio.com.br/api/v1/integration/contacts", {
  method: "POST",
  headers: {
    Authorization: "Bearer SEU_TOKEN_AQUI",
    Accept: "application/json",
    "Content-Type": "application/json",
    "Accept-Language": "pt-BR",
  },
  body: JSON.stringify({
    email: "helena@empresa.com",
    name: "Helena",
    country_code: "55",
    phone_number: "11988887777",
    tags: ["Lead CRM"],
    fields: { empresa: "Acme" },
  }),
});

PHP

$ch = curl_init('https://api.brenvio.com.br/api/v1/integration/contacts');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer SEU_TOKEN_AQUI',
        'Accept: application/json',
        'Content-Type: application/json',
        'Accept-Language: pt-BR',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'email' => 'helena@empresa.com',
        'name' => 'Helena',
        'country_code' => '55',
        'phone_number' => '11988887777',
        'tags' => ['Lead CRM'],
        'fields' => ['empresa' => 'Acme'],
    ]),
]);
$response = curl_exec($ch);
curl_close($ch);

• Se o e-mail já existir, os dados são atualizados.
• Tags: por padrão anexadas (tag_match omitido). Use "tag_match": "replace" para o CRM mandar o conjunto completo.
• CRUD do catálogo de tags: GET/POST/PATCH/DELETE https://api.brenvio.com.br/api/v1/integration/tags (mesmo Bearer).
• E-mails na lista de bloqueio ou na supressão global são rejeitados (não entram na base).

Documentação técnica completa

Portal público (Try It Out, OpenAPI, Postman): docs.brenvio.com.br.