PicChat

Guias

Como funciona o envio

Na PicChat, todo envio pela API passa por uma automação. Não existe um endpoint de "mandar mensagem avulsa": você monta a mensagem uma vez no painel, como automação, e a API só diz para quem ela vai.

Painel (uma vez)                         Seu sistema (a cada envio)
────────────────                         ─────────────────────────
Template aprovado pela Meta              POST /automations/enrollments
        │                                  { automation_id, contacts: [...] }
        ▼                                          │
Automação de disparo  ◄────────────────────────────┘
  · canal (número de WhatsApp)
  · template + variáveis
  · horário comercial e intervalo
        │
        ▼
Mensagem entregue ao contato  →  acompanhe em GET /v1/automations/{id}

Por que assim

  • Conteúdo fica com quem cuida dele. Marketing e atendimento ajustam texto, template e horário no painel sem mexer na integração.
  • Regras do WhatsApp já resolvidas. Template aprovado, janela de 24h, canal certo e intervalo entre envios ficam na automação.
  • Mesmos relatórios do painel. Entregues, lidas e respondidas aparecem na automação, igual a um disparo manual.

Passo a passo

  1. Template — crie e aprove um template no painel (Templates). Use variáveis para o que muda por contato ({{1}} = nome, por exemplo) e ligue cada variável a uma propriedade do contato.
  2. Automação — crie uma automação de disparo com esse template e o canal de envio. Anote o ID dela (está na URL do painel e em GET /v1/automations).
  3. Contatos — garanta que o contato existe, com as propriedades que o template usa: POST /contacts/create-or-update.
  4. Disparo — inscreva o contato na automação: POST /automations/enrollments.
  5. Acompanhamento — veja os totais em GET /v1/automations/{id} e a conversa em GET /v1/tickets / GET /v1/messages.

Para testar sem disparar para clientes, crie uma automação de teste e inscreva só o seu próprio número.

E para ler as respostas?

As respostas dos contatos viram tíquetes na Inbox, como qualquer conversa. Consulte por GET /v1/tickets (filtrando por contato, canal ou período) e GET /v1/tickets/{id}/messages. Veja Ler conversas e dados da conta.