Quick Start
Faca sua primeira integracao com a API NooviChat em 5 minutos.
Pre-requisito: NooviChat instalado e rodando. Veja o guia de instalacao.
1
Obter seu API Token
Acesse o painel do NooviChat, va em Configuracoes → Conta → Token de API e copie seu token.
bash
# Salve seu token como variavel de ambiente
export NOOVICHAT_TOKEN="seu_api_access_token"
export ACCOUNT_ID="1" # ID da sua conta
export BASE_URL="https://chat.seudominio.com"2
Testar autenticacao
Verifique que o token funciona listando suas conversas:
curl -s "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/conversations" \
-H "api_access_token: $NOOVICHAT_TOKEN" | jq .Resposta esperada
Voce deve receber um JSON com data.meta contendo contadores de conversas. Se receber 401, verifique o token.
3
Criar um contato
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/contacts" \
-H "api_access_token: $NOOVICHAT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Maria Silva",
"email": "maria@example.com",
"phone_number": "+5511999999999"
}'4
Criar uma conversa
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/conversations" \
-H "api_access_token: $NOOVICHAT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contact_id": CONTACT_ID,
"inbox_id": 1
}'5
Enviar uma mensagem
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/conversations/CONVERSATION_ID/messages" \
-H "api_access_token: $NOOVICHAT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "Ola! Como posso ajudar?",
"message_type": "outgoing"
}'6
Configurar webhook (opcional)
Receba notificacoes em tempo real quando novas mensagens chegarem:
bash
curl -X POST "$BASE_URL/api/v1/accounts/$ACCOUNT_ID/webhooks" \
-H "api_access_token: $NOOVICHAT_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"url": "https://seuapp.com/webhooks/noovichat",
"subscriptions": ["message_created", "conversation_created"]
}'Veja o guia de webhooks para detalhes sobre eventos e payloads.