Crie seu agente RCS

Preencha as informações abaixo e veja como seu agente ficará no celular em tempo real.

1

Categoria do faturamento do agente

Selecione as categorias que melhor representam os objetivos do seu agente.

Tipo do agente

Você pode selecionar até dois tipos. Isso ajuda a direcionar melhor as interações.

Não Conversacional Para agentes que enviam mensagens pontuais, sem foco em diálogo contínuo.

Conversacional Para agentes que participam de conversas em tempo real com o usuário.

Caso de uso

Selecione um ou mais objetivos para o seu agente.

Transacional Confirmações, avisos e atualizações importantes.

Promocional Ofertas, campanhas e comunicações de marketing.

OTP / Verificação Envio de código de verificação e autenticação.

2

Aparência do agente

Configure o nome, descrição, logo e banner.

Nome de exibição *

Descrição *

Tipos de interações com o usuário *

Logotipo (224x224)* ⇧ Clique para enviar e recortar PNG, JPG ou WEBP

Banner (1440x448)* ⇧ Clique para enviar e recortar Imagem de capa do perfil do agente

Banner selecionado

3

Informações de contato

Dados que poderão aparecer no perfil do agente.

Telefone principal *

Email *

Site principal *

4

Informações legais

Links oficiais, dados da empresa e documentos obrigatórios.

URL dos termos de serviço *

URL da política de privacidade *

CNPJ da empresa *

Cartão de CNPJ * ⇧ Clique para enviar PDF

5

Informações do dono da marca

Contato responsável pela aprovação da marca.

Nome do contato *

Email do contato *

13:25 ◔ 3G 📶 🔋

Preencha o formulário para ver o preview do chat em tempo real.

Logo 224×224

Nome da empresa

Descrição do agente aparecerá aqui.

13:25

Validação de dados: por que é estratégica para empresas?

Pingoo.mobi

＋

Mensagem RCS

🎤

10:27 ◔ 3G 📶 🔋

O perfil do agente será montado automaticamente conforme os dados forem preenchidos.

Logo 224×224

Pingoo

Descrição do agente

Criação de agente via API

Endpoint público para criar uma ou várias combinações de agentes RCS em uma única requisição. Todos os campos documentados abaixo são obrigatórios.

Endpointhttps://agents.pingoo.mobi/rcs/create

Autenticaçãox-api-key: SUA_CHAVE_AQUI

Formatoapplication/json; charset=utf-8

Exemplo de cURL

Envie o JSON completo no corpo da requisição. O endpoint cria uma combinação para cada item de agentTypes × categories.

curl -X POST "https://agents.pingoo.mobi/rcs/create" \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_CHAVE_AQUI" \
  --data-binary @payload.json

Payload JSON completo

Envie todos os campos documentados, incluindo o CNPJ e a URL pública do cartão CNPJ.

{
  "agentDisplayName": "Minha Marca",
  "description": "Atendimento oficial via RCS.",
  "interactionsDescription": "Promoções, suporte e notificações.",
  "logoUri": "https://cdn.marca.com/rcs/logo.jpg",
  "heroUri": "https://cdn.marca.com/rcs/banner.jpg",
  "previewUri": "https://cdn.marca.com/rcs/preview.png",
  "color": "#6D3EE8",
  "phone": "+55 (11) 99999-9999",
  "email": "contato@marca.com.br",
  "website": "https://marca.com.br",
  "privacy": {
    "uri": "https://marca.com.br/privacidade",
    "label": "Política de Privacidade"
  },
  "terms": {
    "uri": "https://marca.com.br/termos",
    "label": "Termos de Serviço"
  },
  "cnpj": "00.000.000/0000-00",
  "cnpjCardUrl": "https://cdn.marca.com/documentos/cartao-cnpj.pdf",
  "brandContactName": "Nome do contato da marca",
  "brandContactEmailAddress": "contato@marca.com.br",
  "brandWebsiteUrl": "https://marca.com.br",
  "agentTypes": ["NON_CONVERSATIONAL", "CONVERSATIONAL"],
  "categories": ["TRANSACTIONAL", "PROMOTIONAL", "OTP"]
}

Resposta esperada

{
  "ok": true,
  "count": 6,
  "plannedCount": 6,
  "agentIds": [
    "agent-1",
    "agent-2",
    "agent-3",
    "agent-4",
    "agent-5",
    "agent-6"
  ],
  "agentUseCase": [
    "TRANSACTIONAL",
    "PROMOTIONAL",
    "OTP"
  ],
  "failures": [],
  "emailAttachments": [
    "cartao-cnpj.pdf"
  ],
  "authorizationEmail": {
    "sent": true,
    "to": [
      "contato@marca.com.br"
    ]
  }
}

Referência completa de campos

Todos os campos aceitos pelo endpoint de criação.

Campo	Tipo	Obrigatório	Descrição	Exemplo